home *** CD-ROM | disk | FTP | other *** search
/ ASP Advantage 1993 / The Association of Shareware Professionals Advantage CD-ROM 1993.iso / files / writions / biblogic / manual.doc < prev    next >
Text File  |  1992-06-18  |  266KB  |  6,382 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                                    ABOUT THIS FILE
  12.  
  13.                This file contains the instruction manual for BIBLOGIC in
  14.           printable form.
  15.  
  16.                It is formatted for printing on an ASCII compatible
  17.           80-column printer with 66 or more lines per page. The file
  18.           contains form-feed characters between pages.
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.                                                                        (TM)
  34.                                                         B I B L O G I C
  35.  
  36.                                                     Bibliographic Reference
  37.                                                            Database Program
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.                   _______
  68.              ____|__     |               (R)
  69.           --|       |    |-------------------
  70.             |   ____|__  |  Association of
  71.             |  |       |_|  Shareware
  72.             |__|   o   |    Professionals
  73.           -----|   |   |---------------------
  74.                |___|___|    MEMBER
  75.  
  76.  
  77.               Biblogic Computer Services
  78.               P.O. Box 1424
  79.               Thousand Oaks
  80.               CA 91358-0424
  81.               U.S.A.
  82.  
  83.  
  84.  
  85.           The BIBLOGIC Bibliographic Database Program was designed by
  86.           ANNE CHAMPION and STEPHEN CHAMPION.
  87.  
  88.           The manual was written by STEPHEN CHAMPION and was revised by
  89.           PETER CROME, JAN SMITH and STEPHEN CHAMPION.
  90.  
  91.           The program was written by STEPHEN CHAMPION using the Clipper
  92.           compiler by Nantucket Corporation.
  93.  
  94.           BIBLOGIC Computer Services would like to thank the users of this
  95.           program for their suggestions, support and encouragement during
  96.           the development of the program and manual.
  97.  
  98.  
  99.  
  100.           Manual first printed December 1987.
  101.           Revised April 1989, January 1992, June 1992.
  102.  
  103.  
  104.  
  105.           Copyright (c) 1987, 1988, 1989, 1990, 1991, 1992
  106.           Stephen Champion, Biblogic Computer Services.
  107.  
  108.           All rights reserved.
  109.  
  110.  
  111.           No part of this document may be reproduced, transmitted,
  112.           transcribed, stored in a retrieval system, or translated into any
  113.           other language, in whole or in part, in any form or by any means,
  114.           whether it be electronic, mechanical, magnetic, optical, manual
  115.           or otherwise, without the prior written permission of the
  116.           publisher and copyright owner.
  117.  
  118.           Biblogic Computer Services believes that the information
  119.           contained in this manual is correct. However, Biblogic Computer
  120.           Services reserves the right to revise this manual and make
  121.           periodic changes to the content, without any obligation to notify
  122.           any person of such revisions or changes. Biblogic Computer
  123.           Services does not assume responsibility for the use of this
  124.           manual or software.
  125.  
  126.           The software supplied with this manual contains valuable trade
  127.           secrets and proprietary information. Unauthorized use of this
  128.           manual or the software can result in prosecution.
  129.  
  130.           IBM is a trademark of International Business Machines Corp.
  131.           Clipper is a trademark of Nantucket Corporation.
  132.           Medline & DIALOG are trademarks of the respective on-line
  133.           service providers.
  134.           CompuServe Mail is the trademark of CompuServe Incorporated.
  135.           BIBLOGIC is a trademark of Biblogic Computer Services.
  136.           Other trademarks are the trademarks of their respective
  137.           trademark owners
  138.           Biblogic Computer Services is a registered business name in the
  139.           state of Queensland, Australia and at Thousand Oaks, California
  140.           USA.
  141.  
  142.  
  143.  
  144.  
  145.                                   Table of Contents
  146.  
  147.  
  148.            1. INTRODUCTION...............................................1
  149.               1.1. ABOUT THIS MANUAL.....................................1
  150.               1.2. THE DEMO PROGRAM......................................1
  151.               1.3. FEATURES OF BIBLOGIC..................................2
  152.               1.4. TECHNICAL REQUIREMENTS................................3
  153.               1.5. DISCLAIMER & AGREEMENT................................3
  154.               1.6. SUPPORT POLICY........................................5
  155.               1.7. INSTALLING THE BIBLOGIC PROGRAM.......................5
  156.                    1.7.1. Installing from floppy disks...................6
  157.                    1.7.2. Installing from downloaded files...............7
  158.  
  159.            2. LEARNING TO USE THE BIBLOGIC PROGRAM.......................8
  160.               2.1. HOW TO USE THIS MANUAL................................8
  161.               2.2. UPGRADING TO THE LATEST VERSION.......................8
  162.               2.3. BASIC PRINCIPLES OF THE BIBLOGIC PROGRAM..............9
  163.                    2.3.1. The screen.....................................9
  164.                    2.3.2. The keyboard...................................9
  165.                    2.3.3. Menus.........................................10
  166.                    2.3.4. File names....................................11
  167.                    2.3.5. Databases.....................................11
  168.                    2.3.6. Records.......................................13
  169.                    2.3.7. Data input....................................13
  170.                    2.3.8. The "Print-Screen" function...................13
  171.               2.4. TUTORIAL - LEARNING BIBLOGIC BY EXAMPLE..............14
  172.                    2.4.1. How to input a book reference.................15
  173.                    2.4.2. How to input a review.........................16
  174.                    2.4.3. How to input an article reference.............18
  175.                    2.4.4. Cursor movements..............................19
  176.                           2.4.4.1. Cursor movement between fields.......19
  177.                           2.4.4.2. Cursor movement between records......19
  178.                    2.4.5. Editing a reference...........................20
  179.                    2.4.6. Examining a reference.........................21
  180.                    2.4.7. Generating a reference list...................21
  181.                    2.4.8. Modifying the format of references............22
  182.  
  183.            3. DESIGNING THE CATEGORY STRUCTURE..........................25
  184.               3.1. WHY USE A CATEGORY STRUCTURE ?.......................25
  185.               3.2. BIBLOGIC CATEGORY STRUCTURES.........................26
  186.               3.3. TYPES OF CATEGORY STRUCTURES.........................26
  187.                    3.3.1. Hierarchical tree structures..................26
  188.                    3.3.2. Matrices......................................27
  189.               3.4. HOW TO DESIGN A CUSTOMIZED CATEGORY STRUCTURE........31
  190.               3.5. CATEGORY STRUCTURES FOR PARTICULAR CIRCUMSTANCES.....38
  191.                    3.5.1. Multiple users................................38
  192.                    3.5.2. Chapters......................................38
  193.                    3.5.3. Critical dates................................39
  194.                    3.5.4. Marking references............................39
  195.                    3.5.5. Zero as a topic code..........................39
  196.                    3.5.6. Other uses....................................39
  197.                    3.5.7. Partial categorization........................40
  198.  
  199.  
  200.  
  201.  
  202.            4. CREATING YOUR OWN REFERENCE DATABASE......................41
  203.               4.1. PREPARING TO INPUT REAL REFERENCES ..................41
  204.                    4.1.1. Making a list of journals.....................41
  205.                    4.1.2. Printing the current journal list.............43
  206.               4.2. INPUTTING REFERENCES.................................44
  207.               4.3. INPUTTING REVIEWS....................................44
  208.               4.4. LISTS................................................45
  209.               4.5. MODIFYING THE PRINT FORMAT...........................46
  210.               4.6. DEVELOPING A BACKUP STRATEGY.........................48
  211.               4.7. ADVANCED FEATURES OF THE BIBLOGIC PROGRAM............49
  212.                    4.7.1. Specific features.............................49
  213.  
  214.            5. BIBLOGIC REFERENCE........................................50
  215.               5.1. STARTING BIBLOGIC....................................50
  216.               5.2. THE BOOKS MENU.......................................52
  217.                    5.2.1. Add - Add new book references.................52
  218.                    5.2.2. Special features..............................55
  219.                           5.2.2.1. Moving the cursor between names......55
  220.                           5.2.2.2. Copying a previous reference.........55
  221.                           5.2.2.3. Checking for duplicates..............56
  222.                    5.2.3. Inputting a review............................57
  223.                    5.2.4. Edit - Change a book reference................58
  224.                           5.2.4.1. Editing by reference number..........58
  225.                           5.2.4.2. Editing with searches................58
  226.                           5.2.4.3. Special author searches..............59
  227.                    5.2.5. Examine - Look at existing book references....60
  228.               5.3. THE ARTICLES MENU....................................61
  229.                    5.3.1. Add - Add new journal article references......61
  230.                           5.3.1.1. Special features.....................63
  231.                    5.3.2. Edit - Change existing references.............63
  232.                    5.3.3. Examine - Look at existing references.........63
  233.               5.4. THE REVIEWS MENU.....................................64
  234.                    5.4.1. Add - Add new reviews.........................64
  235.                           5.4.1.1. Special Features.....................64
  236.                    5.4.2. Edit - Change existing reviews................64
  237.               5.5. THE LISTS MENU.......................................66
  238.                    5.5.1. References - List full references.............66
  239.                    5.5.2. Comments with number..........................68
  240.                    5.5.3. Comments with authors.........................68
  241.                    5.5.4. Comments with reference.......................68
  242.                    5.5.5. Journals - List journal titles................69
  243.                    5.5.6. Manual list...................................70
  244.               5.6. THE SET-UP MENU......................................71
  245.                    5.6.1. Configuration.................................71
  246.                    5.6.2. New journal list..............................73
  247.                    5.6.3. Edit journal list.............................73
  248.                    5.6.4. New database..................................74
  249.                    5.6.5. New print format..............................74
  250.                    5.6.6. Edit print format.............................80
  251.                    5.6.7. Set numbers...................................80
  252.                    5.6.8. Medline/DIALOG conversions....................80
  253.                           5.6.8.1. Medline..............................81
  254.                           5.6.8.2. DIALOG...............................82
  255.  
  256.  
  257.  
  258.  
  259.               5.7. THE UTILITIES MENU...................................83
  260.                    5.7.1. Import........................................83
  261.                    5.7.2. Export........................................83
  262.                    5.7.3. Pack database.................................84
  263.                    5.7.4. Topic code changes............................84
  264.                           5.7.4.1. Add column...........................84
  265.                           5.7.4.2. Delete column........................84
  266.                           5.7.4.3. Individual substitutions.............85
  267.                    5.7.5. Register......................................86
  268.               5.8. EXIT.................................................86
  269.  
  270.  
  271.           Appendices
  272.  
  273.            A. Installing BIBLOGIC on disk drives other than C:..........87
  274.            B. Running BIBLOGIC from other directories...................88
  275.            C. Field sizes...............................................90
  276.            D. Comments field editing....................................93
  277.            E. Backing up, considerations for advanced users.............95
  278.            F. The SOUNDEX algorithm.....................................97
  279.            G. On-screen topic help......................................99
  280.            H. Special effects codes for new word processors............100
  281.  
  282.  
  283.  
  284.  
  285.           Index........................................................102
  286.  
  287.  
  288.                                                                Introduction
  289.  
  290.  
  291.           1. INTRODUCTION
  292.  
  293.                The BIBLOGIC bibliographic database program is a
  294.           research/writing tool which allows the user to store, retrieve
  295.           and print bibliographic information and associated remarks. The
  296.           program can generate selected reference lists in many styles to
  297.           satisfy the requirements of different publishing bodies. It also
  298.           allows users to organize their own notes on references. The
  299.           comments on a particular concept may then be selectively combined
  300.           into a single document for further word processing. BIBLOGIC is
  301.           compatible with most word processors.
  302.  
  303.                The program was initially written to meet the needs of PhD
  304.           candidates who found that existing programs fell short of their
  305.           requirements. Since the first version of this program was
  306.           released, it has been refined to incorporate many suggestions
  307.           from its users. The program is currently being used in
  308.           universities, hospitals and government departments, by
  309.           researchers in a wide range of disciplines.
  310.  
  311.                In order to benefit as many users as possible, BIBLOGIC is
  312.           distributed as "Shareware". Shareware distribution gives you a
  313.           chance to try BIBLOGIC before buying it. If you try BIBLOGIC and
  314.           continue using it, you must register your copy.
  315.  
  316.                When you register your copy, you will receive the right to
  317.           support via fax, mail or CompuServe Mail. You will also be able
  318.           to receive low-cost updates. See page 3 for details of how to
  319.           register your copy.
  320.  
  321.                BIBLOGIC is NOT public domain software. It is copyrighted
  322.           software and, in evaluating or using it, you must adhere to the
  323.           terms set out in the agreement (see page 3).
  324.  
  325.           1.1. ABOUT THIS MANUAL
  326.  
  327.                Since this manual is supplied on disk, its size and the use
  328.           of diagrams is limited. This manual does, however, describe all
  329.           of the features of BIBLOGIC in full.
  330.  
  331.           1.2. THE DEMO PROGRAM
  332.  
  333.                It is strongly recommended that, if you have not already
  334.           done so, you run the demonstration program included in the
  335.           package. This provides a quick overview of how BIBLOGIC works and
  336.           the manual will be much clearer to you if you have run the demo
  337.           program. A batch file DEMO.BAT is included so that (once you have
  338.           installed BIBLOGIC) you can just type "DEMO" at the DOS prompt in
  339.           the BIBLOGIC directory to do this.
  340.  
  341.  
  342.  
  343.  
  344.  
  345.           BIBLOGIC                                                   Page 1
  346.  
  347.                                                                Introduction
  348.  
  349.  
  350.           1.3. FEATURES OF BIBLOGIC
  351.  
  352.           BIBLOGIC incorporates a number of unique features:
  353.  
  354.           *    articles are categorized by a hierarchical numbering system
  355.                which is defined by the user. Retrieval is therefore much
  356.                easier than using keywords. The categories are chosen by the
  357.                user, so they closely match the natural divisions in the
  358.                papers being prepared.
  359.  
  360.           *    The user's comments on the articles (reviews) are kept in a
  361.                different area from the references themselves, along with
  362.                the category numbers. The user, or users, may therefore
  363.                enter multiple reviews for a single reference and so call up
  364.                reviews on different aspects of an article independently.
  365.                Comments on particular topics can be extracted from the
  366.                database and put into a document file for editing with a
  367.                word processor.
  368.  
  369.           *    Output from the program is in the form of text files which
  370.                can be directly read into most word processors. The program
  371.                can be configured to output the correct formatting
  372.                characters so that "special effects" such as bold,
  373.                underline, italics and so on are automatically included in
  374.                the output file (of course, your word processor and printer
  375.                have to be able to handle these effects !).
  376.  
  377.           *    References can be printed in many different formats to
  378.                satisfy the requirements of different journals. Hence,
  379.                producing a list in the format:
  380.  
  381.                SMITH AB, JONES DF and PARKER CV (1984).......
  382.  
  383.                is just as easy as:
  384.  
  385.                A. B. Smith, D. F. Jones & C. V. Parker, (1984)......
  386.  
  387.                This enables the same bibliographic information to be
  388.                readily included in articles submitted to different
  389.                journals.
  390.  
  391.           *    Journal titles are handled so that all references to the
  392.                same journal are exactly the same. The particular
  393.                abbreviation used for a journal name can easily be changed
  394.                for submission to different journals.
  395.  
  396.           *    Provisions for inserting "Cited by" references are provided.
  397.  
  398.           *    The user may develop several databases on one computer,
  399.                using a single copy of the program. A database can contain
  400.                several thousand references.
  401.  
  402.  
  403.  
  404.           BIBLOGIC                                                   Page 2
  405.  
  406.                                                                Introduction
  407.  
  408.  
  409.  
  410.           *    The import and export features of BIBLOGIC allow the
  411.                contents of one BIBLOGIC database to be added to another. A
  412.                selected list of references can be exported to form a
  413.                separate database.
  414.  
  415.           *    Information from certain on-line database services can be
  416.                read into a BIBLOGIC database.
  417.  
  418.           *    A number of different search methods allow the user to
  419.                locate a particular reference, even when it has been
  420.                incompletely categorized. For example, the user may search
  421.                for references with a particular word in the title and
  422.                examine them on-screen.
  423.  
  424.           *    References from the BIBLOGIC database can be listed
  425.                alphabetically, by year, or in an arbitrary order selected
  426.                by the user.
  427.  
  428.           1.4. TECHNICAL REQUIREMENTS
  429.  
  430.                The program runs on an IBM XT, or true compatible, running
  431.           DOS 2.1 or later. The machine must have a hard disk drive and a
  432.           minimum of 640k of memory. It is recommended that you install the
  433.           program on a disk with more than about 2 megabytes of free space.
  434.           Although the program itself does not take up this much room, a
  435.           typical database of several thousand references does take up
  436.           quite a bit of space.
  437.  
  438.           1.5. DISCLAIMER & AGREEMENT
  439.  
  440.                Users of BIBLOGIC must accept the following disclaimer of
  441.           warranty:
  442.  
  443.                "BIBLOGIC IS SUPPLIED AS IS. THE AUTHOR DISCLAIMS ALL
  444.           WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION,
  445.           THE WARRANTIES OF MERCHANTABILITY AND OF FITNESS FOR ANY PURPOSE.
  446.           THE AUTHOR ASSUMES NO LIABILITY FOR DAMAGES, DIRECT OR
  447.           CONSEQUENTIAL, WHICH MAY RESULT FROM THE USE OF BIBLOGIC."
  448.  
  449.                BIBLOGIC is a "shareware program" and is provided at no
  450.           charge to the user for evaluation. Feel free to share it with
  451.           your friends, but please do not give it away altered or as part
  452.           of another system. The essence of "user-supported" software is to
  453.           provide personal computer users with quality software without
  454.           high prices, and yet to provide incentive for programmers to
  455.           continue to develop new products. If you find this program useful
  456.           and find that you are using BIBLOGIC and continue to use BIBLOGIC
  457.           after a reasonable trial period, you must make a registration
  458.           payment of $47 to Biblogic Computer Services at:
  459.  
  460.  
  461.  
  462.  
  463.           BIBLOGIC                                                   Page 3
  464.  
  465.                                                                Introduction
  466.  
  467.  
  468.                          Biblogic Computer Services
  469.                          P.O. Box 1424
  470.                          Thousand Oaks
  471.                          CA 91358-0424
  472.                          U.S.A.
  473.  
  474.                Please make check or money order payable to "Biblogic
  475.           Computer Services". RESIDENTS OF CALIFORNIA MUST ADD SALES TAX.
  476.           Checks should be in US dollars and drawn on a US bank.
  477.  
  478.           Special note:
  479.           We can now accept checks (or cheques!) in Pounds Sterling drawn
  480.           on a UK bank or Australian Dollars drawn on an Australian bank.
  481.           Please use prevailing exchange rates to calculate the correct
  482.           equivalent of US$47.
  483.  
  484.                The $47 registration fee will license one copy for use on
  485.           any one computer at any one time. You must treat this software
  486.           just like a book. Specifically, this software may be used by any
  487.           number of people and may be freely moved from one computer
  488.           location to another, so long as there is no possibility of it
  489.           being used at one location while it's being used at another. Just
  490.           as a book cannot be read by two different persons at the same
  491.           time.
  492.  
  493.                Commercial or institutional users of BIBLOGIC must register
  494.           and pay for their copies of BIBLOGIC within 30 days of first use
  495.           or their license is withdrawn. Site-License arrangements may be
  496.           made by contacting Biblogic Computer Services.
  497.  
  498.                Anyone distributing BIBLOGIC for any kind of remuneration
  499.           must be authorized by Biblogic Computer Services. Please see
  500.           VENDOR.DOC for full details.
  501.  
  502.                This authorization will automatically be granted to
  503.           distributors recognized by the Association of Shareware
  504.           Professionals (ASP) as adhering to its guidelines for shareware
  505.           distributors, and such distributors may begin offering BIBLOGIC
  506.           immediately (However Biblogic Computer Services must still be
  507.           advised so that the distributor can be kept up-to-date with the
  508.           latest version of BIBLOGIC.).
  509.  
  510.                You are encouraged to pass a copy of BIBLOGIC along to your
  511.           friends for evaluation. Please encourage them to register their
  512.           copy if they find that they can use it. All registered users
  513.           receive the right to support via fax, mail or CompuServe Mail.
  514.           They are also eligible to receive low-cost updates.
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.           BIBLOGIC                                                   Page 4
  523.  
  524.                                                                Introduction
  525.  
  526.  
  527.           1.6. SUPPORT POLICY
  528.  
  529.                Biblogic Computer Services undertakes to support registered
  530.           users of BIBLOGIC by answering queries relating to the program by
  531.           fax, mail or CompuServe Mail.
  532.  
  533.                Biblogic Computer Services' policy on support is as follows.
  534.           It is subject to change without notice.
  535.  
  536.           1)   Support is limited to registered users only. In the case of
  537.                site licenses, a single contact person will be designated.
  538.                Requests for support must include the serial number given at
  539.                the time of registration.
  540.  
  541.           2)   Requests for support must be by mail, fax or CompuServe
  542.                Mail.
  543.  
  544.           3)   All support requests from registered users will be
  545.                acknowledged.
  546.  
  547.           4)   So far, it has not been necessary to limit the number of
  548.                support requests that a registered user may make. Biblogic
  549.                Computer Services reserves the right to limit the total
  550.                number of support requests or limit the period for which
  551.                support is available. In any case, limits will be in excess
  552.                of those recommended by the Association of Shareware
  553.                Professionals.
  554.  
  555.           5)   Biblogic Computer Services does not undertake to provide
  556.                support for programs other than Biblogic.
  557.  
  558.           1.7. INSTALLING THE BIBLOGIC PROGRAM
  559.  
  560.                The method used to install BIBLOGIC depends on whether you
  561.           obtained the program on disks or by downloading from CompuServe
  562.           (or a BBS).
  563.  
  564.                The disk version of the program includes an install program
  565.           which unpacks the package from compressed files, copies the files
  566.           to your hard disk, and modifies your CONFIG.SYS if required. You
  567.           may elect to alter your CONFIG.SYS manually if you prefer.
  568.  
  569.                The download version of BIBLOGIC consists of two compressed
  570.           files, which you must decompress manually. You must also edit
  571.           your CONFIG.SYS file yourself.
  572.  
  573.                The following instructions are for the most common type of
  574.           installation. If you have special requirements, please see page
  575.           87 and 88.
  576.  
  577.  
  578.  
  579.  
  580.  
  581.           BIBLOGIC                                                   Page 5
  582.  
  583.                                                                Introduction
  584.  
  585.  
  586.           1.7.1. Installing from floppy disks
  587.  
  588.                The installation program creates a subdirectory called
  589.           C:\BIBLOGIC and installs the program and example databases in
  590.           this subdirectory. The program itself and the databases you
  591.           create will all reside in this sub-directory. It is possible to
  592.           install the program in a directory other than "\BIBLOGIC" (see
  593.           page 88) if you have special reasons to do so.
  594.  
  595.                The installation program will warn you if the directory that
  596.           you have chosen already contains a copy of BIBLOGIC.EXE. If you
  597.           are updating an old BIBLOGIC installation, please be sure to
  598.           follow the instructions in the README.DOC file in the new
  599.           package. The update instructions will ensure that you copy across
  600.           the new version of BIBLOGIC without overwriting any of your
  601.           existing files, which you may want to keep.
  602.  
  603.                To begin installing the BIBLOGIC program, ensure your
  604.           computer is displaying the DOS prompt (for example "C:\>"). Place
  605.           the first BIBLOGIC distribution disk in drive A: and type:
  606.  
  607.                "A:INSTALL<Enter>"
  608.  
  609.           Installation will then begin. Follow the instructions on the
  610.           screen. If you are using floppy drive B:, substitute B: for A: in
  611.           the above line.
  612.  
  613.                When this process is complete, take out the distribution
  614.           disks and store it them in a safe place.
  615.  
  616.                You may want to put the BIBLOGIC directory on the "path" so
  617.           that you can run it from any subdirectory. See page 88 for
  618.           details of how to do this.
  619.  
  620.           IMPORTANT NOTE:
  621.  
  622.           If you intend to give a copy of BIBLOGIC to somebody for
  623.           evaluation, be sure to give them an exact copy of the
  624.           distribution disks and not a copy from your hard disk. This is
  625.           for two reasons. Firstly, it is a condition of your license
  626.           agreement that only complete and unaltered copies of the BIBLOGIC
  627.           package are distributed. Secondly, novice users may have
  628.           difficulty with a copy of the program which is not set-up EXACTLY
  629.           as on distribution disks, since this manual makes certain
  630.           assumptions about the way BIBLOGIC is set up in the tutorial
  631.           section.
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.           BIBLOGIC                                                   Page 6
  641.  
  642.                                                                Introduction
  643.  
  644.  
  645.           1.7.2. Installing from downloaded files
  646.  
  647.                If you downloaded the BIBLOGIC package from CompuServe or a
  648.           BBS, it is installed as follows:
  649.  
  650.           1)   Create a directory called "\BIBLOGIC" in the root directory
  651.                on your hard disk.
  652.  
  653.           2)   Decompress both of the compressed files (BIBLOGI1 and
  654.                BIBLOGI2) into the new directory (some BBSs carry BIBLOGIC
  655.                as a single compressed file called BIBLOGIC).
  656.  
  657.           3)   Edit your CONFIG.SYS file to ensure that you have FILES=20
  658.                (minimum) and BUFFERS=15 (minimum).
  659.  
  660.           4)   Reboot your computer if you altered CONFIG.SYS.
  661.  
  662.           Larger values for both files and buffers are permissible, but
  663.           will not necessarily make BIBLOGIC run any faster. Excessively
  664.           large values will reduce the amount of memory available to
  665.           BIBLOGIC to the extent that it will be unable to run. BIBLOGIC
  666.           will not function properly with smaller values.
  667.  
  668.                If the CONFIG.SYS file on your disk already has larger
  669.           values than those shown above, leave them as they are because
  670.           they may be necessary for other software packages you already
  671.           have installed.
  672.  
  673.                Ultimately you may want to put the BIBLOGIC directory on the
  674.           "path" so that you can run it from any subdirectory. See page 88
  675.           for details of how to do this.
  676.  
  677.  
  678.  
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.           BIBLOGIC                                                   Page 7
  700.  
  701.                                                                    Learning
  702.  
  703.  
  704.           2. LEARNING TO USE THE BIBLOGIC PROGRAM
  705.  
  706.           2.1. HOW TO USE THIS MANUAL
  707.  
  708.                This manual is separated into several sections.
  709.  
  710.                The learning section provides a quick introduction to the
  711.           BIBLOGIC program and how to use its many features. It includes
  712.           basic information and practice examples.
  713.  
  714.                The section on category structures outlines how to design a
  715.           category structure to suit your references.
  716.  
  717.                The section entitled "Creating your own reference database"
  718.           explains how to input your own references. It is recommended that
  719.           you follow through these sections to learn how to use the
  720.           BIBLOGIC system quickly.
  721.  
  722.                The reference section contains comprehensive explanations of
  723.           the various commands and features of the BIBLOGIC program. It is
  724.           organized menu by menu so you can easily find information.
  725.  
  726.                The appendices which follow the reference section provide
  727.           technical information about the BIBLOGIC program.
  728.  
  729.                Finally, a separate supplement (SUPPL.DOC) contains the
  730.           latest information regarding using particular word processors.
  731.  
  732.           2.2. UPGRADING TO THE LATEST VERSION
  733.  
  734.                Since BIBLOGIC was first released, there have been many
  735.           additions and improvements to the program. This has occurred in
  736.           response to requests from BIBLOGIC users. As each new version is
  737.           released the changes are documented in a text file called
  738.           "README.DOC" which is supplied on the BIBLOGIC distribution
  739.           disks. This file also contains instructions on updating from one
  740.           version to another. To view the latest updates to the program put
  741.           the distribution disk in drive A: and type:
  742.  
  743.                TYPE A:README.DOC    then press the <Enter> key.
  744.  
  745.                This file may also be printed using the DOS "Print" command
  746.           (see your DOS manual for details).
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.           BIBLOGIC                                                   Page 8
  759.  
  760.                                                                    Learning
  761.  
  762.  
  763.           2.3. BASIC PRINCIPLES OF THE BIBLOGIC PROGRAM
  764.  
  765.                Before you start using the program you should familiarize
  766.           yourself with some basic principles. If you already use your
  767.           computer for other applications (such as word processing) much of
  768.           this will be familiar, but please read through this section as
  769.           there are some items which are specific to this program which you
  770.           should know.
  771.  
  772.           2.3.1. The screen
  773.  
  774.                In the BIBLOGIC program, text put on the screen by the
  775.           program is differentiated from text YOU have typed in by the way
  776.           the text is displayed. Text output by the program is output as
  777.           colored text on a black background (normal text) and text YOU
  778.           type in is usually shown as black text on a colored background
  779.           (reverse, or inverse video).
  780.  
  781.                The cursor is a flashing "underline" symbol (_) which
  782.           appears on the screen to indicate the position at which the next
  783.           character you type will be put.
  784.  
  785.           2.3.2. The keyboard
  786.  
  787.                In this manual, text that YOU type in on the keyboard to
  788.           complete a specific task, is shown inside quotation marks. For
  789.           example:
  790.  
  791.                "BIBLOGIC <Enter>"
  792.  
  793.                Special keys are shown inside angle brackets <>, shown as
  794.           you should find them marked on your keyboard. Everything else is
  795.           shown exactly as you should type it. Do not type the quotation
  796.           marks. Keyboards differ slightly, and you may find that certain
  797.           keys are marked differently on your keyboard. Some possible
  798.           variations are:
  799.  
  800.           In this document:                  Some Keyboards:
  801.           <Enter>                            <Enter> <Return> or < <---' >
  802.           <Back Space>                       <Bsp> or < <-- >
  803.           <Ins>                              <Insert>
  804.           <Del>                              <Delete>
  805.           <Ctrl>                             <Control>
  806.           <Pg Up>                            <Page Up>
  807.           <Pg Dn>                            <Page Down>
  808.  
  809.                The "arrow keys" which are used to move the cursor around
  810.           the screen are, on most keyboards, dual purpose keys which can
  811.           also be used for numeric input. These are an alternative to the
  812.           numbers above the QWERTYUIOP keys. To use these keys to move the
  813.           cursor around, the <Num Lock> must be off. This is turned on or
  814.  
  815.  
  816.  
  817.           BIBLOGIC                                                   Page 9
  818.  
  819.                                                                    Learning
  820.  
  821.  
  822.           off by pressing the <Num Lock> key once. The <Num lock> light
  823.           shows the current state. On most computers the <Num Lock> is off
  824.           when the computer is first switched on. Some extended keyboards
  825.           have separate keys for numbers and arrows.
  826.  
  827.                The <Ctrl> key ("Control" key) is used in a similar way to
  828.           the <Shift> key. For example, to obtain the sequence shown in
  829.           this text as <Ctrl Q>, press the <Ctrl> key, and while holding it
  830.           down, press the <Q> key. The keys can be released in any order.
  831.  
  832.                The <Esc> key also has a special function. In most parts of
  833.           the program it can be used to "escape" from what you are doing
  834.           and return to the menu (see below). If the program is in the
  835.           middle of something very complicated it may be a little while
  836.           before it acknowledges your request to "escape". If there is a
  837.           delay, be patient, as one press of <Esc> will be enough to stop
  838.           the process. You may have to wait for the program to get to a
  839.           stage where it can safely escape from what it is doing in a tidy
  840.           manner.
  841.  
  842.                The function keys <F1> to <F10> have special functions in
  843.           certain parts of the program. These functions are described in
  844.           the appropriate part of the reference section of this manual.
  845.  
  846.                If you hold any key down for more than a very short time,
  847.           the "auto-repeat" function of your computer will be activated.
  848.           This function makes the keyboard react as if you have pressed the
  849.           key many times in quick succession. Although this function is
  850.           quite useful when you are word processing (for example), it may
  851.           be confusing in a program like BIBLOGIC. Be careful not to rest
  852.           your fingers on the keys after pressing them.
  853.  
  854.           2.3.3. Menus
  855.  
  856.                The BIBLOGIC program is a menu driven system. This means
  857.           that it allows the user to control the program by selecting from
  858.           lists of options that are displayed on screen, rather than by
  859.           typing commands.
  860.  
  861.                After the program is loaded, the program's MAIN menu page
  862.           will be displayed.
  863.  
  864.                The menu names are shown across the top line of the screen.
  865.           The current menu (initially the BOOKS menu) is highlighted and
  866.           below the name of the menu, the sub-menu choices appear. To
  867.           access these menus, you may use one of two methods to move the
  868.           highlight from one menu name to another. You may use the left-
  869.           and right-arrow keys to move through the menus or you may select
  870.           a particular menu by pressing the letter corresponding to the
  871.           first letter of the menu name. The EXIT menu may also be reached
  872.           by pressing <Esc>.
  873.  
  874.  
  875.  
  876.           BIBLOGIC                                                  Page 10
  877.  
  878.                                                                    Learning
  879.  
  880.  
  881.  
  882.                Once a menu has been chosen, the particular option required
  883.           is selected by moving the highlight within the menu to the
  884.           required option with the up- and down-arrow keys. The item is
  885.           then selected by pressing the <Enter> key. Alternatively, the
  886.           required option may be selected by pressing the number alongside
  887.           the option. With this method you do not need to press <Enter> to
  888.           select the option. Since the menus are selected by letters and
  889.           the menu items by numbers, you can move freely around the options
  890.           with very few keystrokes.
  891.  
  892.                As you move the highlight around the menu options, a one-
  893.           line description of what each option does appears in the middle
  894.           of the screen. At the bottom of the screen a box containing
  895.           information about the current status of the program is displayed.
  896.           This box tells you which database, which print format and which
  897.           journal list is currently selected. On a registered copy, the
  898.           registered owner's name is also displayed.
  899.  
  900.                Note that, when you are required to input a response to a
  901.           question a "default" response will often be shown on the screen
  902.           where your response is to be typed. If this is the response you
  903.           wish to make, just press <Enter> to accept this answer.
  904.  
  905.           2.3.4. File names
  906.  
  907.                In a number of instances you will be asked to provide a name
  908.           for a file. For example, this will occur when copying or creating
  909.           a database. A file name consists of up to eight characters, a
  910.           period (full stop) and a further three characters. For example:
  911.  
  912.                DATABASE.BKS
  913.  
  914.                The last four characters are called the filename extension.
  915.           BIBLOGIC ALWAYS supplies the extension, so you must only type the
  916.           main part of the file name. It must consist of up to eight
  917.           letters and numbers, and no other characters can be a part of a
  918.           file name in BIBLOGIC. Note that although DOS allows the use of
  919.           certain punctuation symbols, BIBLOGIC does not.
  920.  
  921.           2.3.5. Databases
  922.  
  923.                The BIBLOGIC program can be used to maintain any number of
  924.           independent databases, providing there is enough space on the
  925.           disk. You can tell it which database to use with options on the
  926.           SET-UP menu. Let us initially consider a single database called
  927.           "EXAMPLE".
  928.  
  929.  
  930.  
  931.  
  932.  
  933.  
  934.  
  935.           BIBLOGIC                                                  Page 11
  936.  
  937.                                                                    Learning
  938.  
  939.  
  940.                The database "EXAMPLE" would actually consist of several
  941.           files, the main ones being:
  942.  
  943.                EXAMPLE.BKS    Which will contain bibliographic details on
  944.                               books, or chapters in books.
  945.                EXAMPLE.JAR    Which will contain bibliographic information
  946.                               on journal articles.
  947.                EXAMPLE.RVU    Which will contain comments on the articles,
  948.                               chapters and books, and information
  949.                               categorizing them.
  950.  
  951.                The database is split up in this way for two reasons.
  952.           Separating the bibliographic data of books and journals allows
  953.           savings in disk space. Separating notes and category information
  954.           (reviews) from the bibliographic information allows multiple
  955.           reviews on an article when this is appropriate. Although book and
  956.           journal information is stored in different files, the program
  957.           uses both of these files when compiling reference lists.
  958.  
  959.                In addition to these files, the program also uses other
  960.           files which initially have the following names:
  961.  
  962.                EXAMPLE.JLS    Which will contain a numbered list of journal
  963.                               titles.
  964.                EXAMPLE.PFF    Which will contain details on how a reference
  965.                               should be printed, including special codes to
  966.                               produce effects such as bold, underline and
  967.                               so on (if this is possible with the word
  968.                               processor that you use).
  969.  
  970.                If you are the only person using the system, you will
  971.           probably want to keep all of your information in a single
  972.           database. To satisfy the formatting requirements of different
  973.           journals to which you submit articles, you may need to use the
  974.           SET-UP menu to select different print format (.PFF) files. This
  975.           will allow you to easily vary the format of the printed reference
  976.           list (see page 74). You may also need to keep more than one
  977.           journal list (.JLS) file. Multiple lists would usually represent
  978.           the same set of journal names, but would contain different
  979.           abbreviations of the names to satisfy the conventions adopted in
  980.           different journals.
  981.  
  982.                If there are several users utilizing the program with
  983.           multiple databases, you will use the options on the SET-UP menu
  984.           to allow you to switch between different databases. Hence there
  985.           will be several sets of files like those listed above.
  986.  
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.           BIBLOGIC                                                  Page 12
  995.  
  996.                                                                    Learning
  997.  
  998.  
  999.                As well as the files listed above which you will be aware of
  1000.           when using the program, the program also maintains a number of
  1001.           other files which are not directly "seen" by the user:
  1002.  
  1003.           EXAMPLE.IBK
  1004.           EXAMPLE.IJA    Which are indexes to the database files which the
  1005.           EXAMPLE.IRV    program uses to locate information quickly when
  1006.           EXAMPLE.IJL    you request it.
  1007.           EXAMPLE.IJT
  1008.  
  1009.           EXAMPLE.DBT    Containing text associated with EXAMPLE.RVU
  1010.           EXAMPLE.NUM    Containing information allowing the program to
  1011.                          properly assign numbers to your references.
  1012.  
  1013.           2.3.6. Records
  1014.  
  1015.                The databases are divided into RECORDS. Each record pertains
  1016.           to a particular journal article or book, and consists of several
  1017.           FIELDS. For example, in a record pertaining to a particular book,
  1018.           there are separate fields for the chapter name, book title,
  1019.           publisher, place of publication and so on.
  1020.  
  1021.           2.3.7. Data input
  1022.  
  1023.                When data is to be input into fields a "blank form" will be
  1024.           displayed on the screen. Data is input by filling in the empty
  1025.           boxes. Each box represents a field in the record and they are
  1026.           labeled so you can identify them. Specific details of this
  1027.           process are included in the examples later in this section.
  1028.  
  1029.           2.3.8. The "Print-Screen" function
  1030.  
  1031.                If you have an ASCII printer connected to port LPT1 of your
  1032.           computer, DOS allows you to print the contents of the screen.
  1033.           This is achieved by pressing the <Shift> key, holding it down,
  1034.           and pressing the <PrtSc> key. All of the regular text that
  1035.           appears on the screen will be printed. Note that graphics symbols
  1036.           (lines and boxes) may not print properly on some printers.
  1037.  
  1038.                The print screen function is very useful in BIBLOGIC when
  1039.           using the "Examine existing reference" options. It can be used to
  1040.           make a print out of the reference displayed on the screen. This
  1041.           is useful as it provides the user with a hard copy of the
  1042.           reference details, and in particular the reference number.
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.           BIBLOGIC                                                  Page 13
  1054.  
  1055.                                                                    Learning
  1056.  
  1057.  
  1058.           2.4. TUTORIAL - LEARNING BIBLOGIC BY EXAMPLE
  1059.  
  1060.                The easiest way to learn to use the BIBLOGIC program is by
  1061.           example. This section contains examples which show you how to
  1062.           input book and journal references and reviews. This section also
  1063.           deals with extracting information from the database.
  1064.  
  1065.                If you have just installed BIBLOGIC, it is set up to use a
  1066.           database called "EXAMPLE". You can add fictitious references to
  1067.           this database to practice using the program, and later delete the
  1068.           database. Do not type fictitious references into BIBLOGIC when
  1069.           somebody else has installed the program for their own use. You
  1070.           may be adding to a real database.
  1071.  
  1072.                After you have installed the program as instructed, first
  1073.           make sure that you are "logged" onto the correct drive, by typing
  1074.           (for example):
  1075.  
  1076.                "C:<Enter>"
  1077.  
  1078.           then go to the BIBLOGIC directory by typing:
  1079.  
  1080.                "CD\BIBLOGIC<Enter>"
  1081.  
  1082.           Now run the program by typing:
  1083.  
  1084.                "BIBLOGIC<Enter>"
  1085.  
  1086.                When biblogic is run, there will be a short delay while the
  1087.           program is loaded from the disk. You will then see a screen
  1088.           giving copyright information. Read this screen and then press
  1089.           <Enter> to continue.
  1090.  
  1091.                A few seconds later the BIBLOGIC MAIN menu screen will be
  1092.           displayed. This menu screen gives you access to all of the
  1093.           BIBLOGIC menus. The menu options, listed below, are displayed
  1094.           across the top of the MAIN menu screen. If instead you see
  1095.           messages about missing files, the installation has not been
  1096.           completed successfully, or your disk package is not complete.
  1097.           Check that you have the correct values in your CONFIG.SYS file.
  1098.  
  1099.                The BIBLOGIC MAIN menu options are:
  1100.  
  1101.                          Books
  1102.                          Articles
  1103.                          Reviews
  1104.                          Lists
  1105.                          Set-up
  1106.                          Utilities
  1107.                          Exit
  1108.  
  1109.  
  1110.  
  1111.  
  1112.           BIBLOGIC                                                  Page 14
  1113.  
  1114.                                                                    Learning
  1115.  
  1116.  
  1117.           2.4.1. How to input a book reference
  1118.  
  1119.                At the MAIN menu you should see that "Books" is the
  1120.           currently highlighted menu (if it is not, use the left- and
  1121.           right-arrow keys to move the highlight to the BOOKS menu). The
  1122.           options on the BOOKS menu are:
  1123.  
  1124.                          1. Add (new article references)
  1125.                          2. Edit (existing references)
  1126.                          3. Examine (existing references)
  1127.  
  1128.                To input a new book or a chapter of a book select option 1
  1129.           (Add). If the Add option on this menu is not already highlighted
  1130.           use the up- or down-arrow keys to move the highlight to the Add
  1131.           option, and then type <Enter> to select it. Alternatively, the
  1132.           Add option can be selected by just pressing <1>.
  1133.  
  1134.                The screen will clear and a reference form (record) with a
  1135.           number of empty boxes (fields) will appear. These labeled fields
  1136.           represent the bibliographic details that need to be filled in for
  1137.           each reference.
  1138.  
  1139.                At this stage you should enter a fictitious reference into
  1140.           the example database that has been created for you to practice.
  1141.           You can use the example given, or make up your own. The example
  1142.           database will be erased after the completion of the tutorial
  1143.           section. To fill in the Author fields, type in the following
  1144.           names, using lower case letters. The program will automatically
  1145.           substitute capitals in names where appropriate. After entering
  1146.           the author's surname type <Enter> to move to the initial field.
  1147.           Continue and type <Enter> on completion of each field in order to
  1148.           move onto the next field. Press <Enter> without typing anything
  1149.           else to skip over unused initial fields. For example, type:
  1150.  
  1151.                "smith<Enter>a<Enter>b<Enter>c<Enter>"
  1152.                "jones<Enter>d<Enter>e<Enter>"
  1153.  
  1154.                Once you have finished entering the authors' names press
  1155.           <Enter> instead of typing a surname to move into the Editor
  1156.           fields. Type the editors' names:
  1157.  
  1158.                "peters<Enter>f<Enter><Enter><Enter>"
  1159.                "evans<Enter>g<Enter>h<Enter><Enter>"
  1160.  
  1161.           After entering the editors' names, move on to the year by
  1162.           pressing <Enter> in an empty editor surname field.
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.           BIBLOGIC                                                  Page 15
  1172.  
  1173.                                                                    Learning
  1174.  
  1175.  
  1176.                You will notice that, in the name fields, the program
  1177.           automatically capitalizes the first letter of the surnames and
  1178.           the initials. You must do your own capitalization for all of the
  1179.           other fields. Continue, entering the following details into the
  1180.           appropriate fields to complete the reference screen.
  1181.  
  1182.                While you are inputting data to this screen the flashing
  1183.           cursor shows the current position on the screen. To fill out a
  1184.           field and move onto the next one, simply type information into
  1185.           the box and press <Enter>. The cursor moves on to the next field.
  1186.           For the moment, don't worry about mistakes in the information you
  1187.           are typing. If you really want to, you can go back to previous
  1188.           fields to make alterations by using the up-arrow key.
  1189.  
  1190.                Fill out, for example:
  1191.  
  1192.                Field labeled:                Type:
  1193.  
  1194.                Year                          "1987<Enter>"
  1195.                Edition                       "1st<Enter>"
  1196.                Chapter                       "Chapter title<Enter>"
  1197.                Book Title                    "Title of the book<Enter>"
  1198.                Published by                  "Publisher<Enter>"
  1199.                at                            "Place<Enter>"
  1200.                Pages                         "100<Enter>105<Enter>"
  1201.  
  1202.                Note that this book record is number B1. The program numbers
  1203.           the reference automatically and displays the number between the
  1204.           page numbers and notes fields.
  1205.  
  1206.                The above example provides a very basic description of
  1207.           filling in a book record. A more thorough explanation can be
  1208.           found in the reference section on page 52. Details on complex
  1209.           author or editor's names, specific field information and advanced
  1210.           features are included in the reference section.
  1211.  
  1212.           2.4.2. How to input a review
  1213.  
  1214.                When you have completed filling the fields in the book
  1215.           screen, the program will automatically present you with a review
  1216.           screen. You will see that the review screen contains some
  1217.           bibliographic information on the reference and some blank fields.
  1218.           The program requires you to enter at least one review for a new
  1219.           reference.
  1220.  
  1221.                The TOPIC field is for the code which categorizes the
  1222.           reference. You will learn about topic codes in the section on
  1223.           category structures (see page 25). The PAGE field can be used to
  1224.           refer to the particular part of the book or journal article you
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.           BIBLOGIC                                                  Page 16
  1231.  
  1232.                                                                    Learning
  1233.  
  1234.  
  1235.           are commenting on. This is usually only used for very lengthy
  1236.           references. The COMMENTS field is for your notes on the book or
  1237.           journal article.
  1238.  
  1239.                The comments field is different from all the other fields
  1240.           you have so far encountered. Firstly it is not shown in "inverse
  1241.           video" and secondly it is a "variable length field", that is to
  1242.           say you can type as much or as little text as you like into it.
  1243.           The area at the bottom of the reviews screen is a "window"
  1244.           through which you can see the text. When the window is filled,
  1245.           the text "scrolls" upwards within the window. Press <F3> to move
  1246.           down to the comment field then input the example comment.
  1247.  
  1248.           "Good overview, but poor detail in method section. Check to see
  1249.           if David has the original thesis.<Enter><Enter>"
  1250.  
  1251.                Notice how the program puts the next word on a new line when
  1252.           the maximum line-length is exceeded.
  1253.  
  1254.                To see how the window scrolls, fill up the page by just
  1255.           putting one letter on each line then typing <Enter>. When you
  1256.           come to the bottom of the page you will notice that the screen
  1257.           rolls up so that you can continue inputting text.
  1258.  
  1259.                When entering comments you should not press <Enter> at the
  1260.           end of each line. Press <Enter> only at the end of each
  1261.           paragraph. This is because the text is ultimately destined for a
  1262.           word processor file, where the line lengths may be different.
  1263.           Pressing <Enter> puts a "hard" (fixed) new-line into the text,
  1264.           whereas just typing beyond the end of the line and letting the
  1265.           program organize the text, does not. Full details of how to use
  1266.           this simple comments word processor are included in an appendix
  1267.           (see page 93).
  1268.  
  1269.                When you have finished typing comments, press <F4> to get
  1270.           back to the other fields.
  1271.  
  1272.            Type the following to fill the page and topic fields:
  1273.  
  1274.                "1223415A<Enter>1<Enter>"
  1275.  
  1276.           Another blank review screen will appear which can be filled if
  1277.           you want to input more than one review for the reference. Once
  1278.           you have finished entering reviews, press <Esc> at a blank review
  1279.           screen. This will return you to a blank book reference screen.
  1280.           You could now continue to enter further book references or press
  1281.           <Esc> to return to the MAIN menu. Press <Esc>.
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.           BIBLOGIC                                                  Page 17
  1290.  
  1291.                                                                    Learning
  1292.  
  1293.  
  1294.                It is possible to avoid inputting a review for a reference
  1295.           by pressing <Esc> at the initial blank review screen. This is not
  1296.           recommended as the topic codes in the reviews are used to search
  1297.           when generating reference lists.
  1298.  
  1299.           2.4.3. How to input an article reference
  1300.  
  1301.                We will now look at how to enter a article reference into a
  1302.           database. Select the Article menu, by pressing <A> or by using
  1303.           the arrow keys. You will now see the article menu:
  1304.  
  1305.                          1. Add (new article references)
  1306.                          2. Edit (existing references)
  1307.                          3. Examine (existing references)
  1308.  
  1309.                Type <1> to select the add option to enter a new journal
  1310.           article reference. Putting in article records is done in a
  1311.           similar way to the way book records are entered. Make up two or
  1312.           three authors names and type them into the blank fields, for
  1313.           example:
  1314.  
  1315.                     "jenkins<Enter>a<Enter><Enter><Enter>"
  1316.                     "macDonald<Enter>b<Enter>c<Enter><Enter>"
  1317.                     "smith<Enter>d<Enter><Enter><Enter>"
  1318.  
  1319.                To move to the journal Title field after you have completed
  1320.           entering authors names simply type <Enter> at an empty Author
  1321.           surname field. Now enter some data into the remaining fields. For
  1322.           example you could type:
  1323.  
  1324.                Field:                        Type:
  1325.  
  1326.                Title                         "A journal article<Enter>"
  1327.                Journal                       "3<Enter>"
  1328.                Year                          "1986<Enter>"
  1329.                Volume                        "24<Enter>"
  1330.                Supplement                    "<Enter>"
  1331.                Pages                         "15<Enter>24<Enter>"
  1332.  
  1333.                Note that this journal article record is numbered J1. The
  1334.           program numbers the reference automatically and displays this
  1335.           number between the page numbers and notes fields.
  1336.  
  1337.                When you have finished inputting the reference press <Pg Dn>
  1338.           to save the bibliographic information and move onto a blank
  1339.           review screen. To input a review for an article follow the same
  1340.           guidelines that were outlined above for the book review. Now
  1341.           input a review for the article you have just entered, filling in
  1342.           each field as appropriate.
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.           BIBLOGIC                                                  Page 18
  1349.  
  1350.                                                                    Learning
  1351.  
  1352.  
  1353.           2.4.4. Cursor movements
  1354.  
  1355.           2.4.4.1. Cursor movement between fields
  1356.  
  1357.                Now that you have entered some references and reviews, you
  1358.           can learn how to move the cursor around the screen more quickly.
  1359.           As well as moving through the fields in sequence using the
  1360.           <Enter> key, you can move back and forth between the fields by
  1361.           using the following special keys:
  1362.  
  1363.                <Back Space>   Delete the last character typed into the box
  1364.                < <- >         Move back one character within a box
  1365.                < -> >         Move forward one character within a box
  1366.                <"up-arrow">   Move back one box
  1367.                <"down-arrow"> Move forward one box
  1368.                <Ctrl -> >     Move cursor forward one word
  1369.                <Ctrl <- >     Move cursor back one word
  1370.                <Home>         Move to start of box
  1371.                <End>          Move to end of box
  1372.                <Ctrl Home>    Move to first box
  1373.                <Ctrl End>     Move to last box
  1374.                <Pg Up>        Move back one screen
  1375.                <Pg Dn>        Move forward one screen
  1376.                <Ins>          Turn insert mode on (or off, if it is on)
  1377.                <Del>          Delete a character
  1378.                <Ctrl T>       Delete word
  1379.                <Ctrl Y>       Delete whole box
  1380.                <Ctrl U>       Restore box to original contents
  1381.  
  1382.           2.4.4.2. Cursor movement between records
  1383.  
  1384.                To move on to the next record without going though the rest
  1385.           of the fields on the screen one by one, use the <Pg Dn> key. This
  1386.           has exactly the same effect as pressing <Enter> at each of the
  1387.           remaining fields on the screen. In certain circumstances (for
  1388.           example when using the examine option) the <Pg Up> key can be
  1389.           used to go to the previous record.
  1390.  
  1391.                If you are finished with the database, press <Pg Dn> to get
  1392.           to a blank record screen and then press <Esc> to go back to the
  1393.           MAIN menu. If you are not in a blank record, pressing <Esc> will
  1394.           still quit from the current record and return you to the MAIN
  1395.           menu, BUT THE NEW RECORD WILL NOT BE SAVED.
  1396.  
  1397.  
  1398.  
  1399.  
  1400.  
  1401.  
  1402.  
  1403.  
  1404.  
  1405.  
  1406.  
  1407.           BIBLOGIC                                                  Page 19
  1408.  
  1409.                                                                    Learning
  1410.  
  1411.  
  1412.           2.4.5. Editing a reference
  1413.  
  1414.                The procedure for editing information in a book, journal
  1415.           article or review record is similar. For practice you will now
  1416.           edit the book record that you entered earlier. Return to the MAIN
  1417.           menu if you are not already there. Select the Book menu, by
  1418.           pressing <B>. Press <3> to select the edit option for a book
  1419.           reference record.
  1420.  
  1421.                You will be asked for the number of the reference to edit.
  1422.           This is the quickest way to locate a record (Alternative methods
  1423.           of finding a particular record are described later). You should
  1424.           type:
  1425.  
  1426.                "1<Enter>"
  1427.  
  1428.           The record that you entered earlier will be displayed on the
  1429.           screen. The cursor will be positioned in the first Author surname
  1430.           field. Change the name of the first author to "Williams". You may
  1431.           change a few of the other details for practice. To save the
  1432.           changes when you have finished editing, press either <Pg Dn> or
  1433.           <Ctrl W>. Pressing <Esc> will save all of the changes made except
  1434.           for any changes to the field currently being edited. This allows
  1435.           you to escape from changes accidentally made to a field.
  1436.  
  1437.                When you are editing existing references, the program will
  1438.           find them much more quickly if you can supply the reference
  1439.           number. If you are unable to do so, it is possible to search for
  1440.           a reference by specifying a string of characters to search for.
  1441.           Try this now.
  1442.  
  1443.                First select the edit option at the BOOKS menu. When asked
  1444.           for the reference number, just press <Enter> instead of giving a
  1445.           number.
  1446.  
  1447.                A new screen is displayed which requires details which allow
  1448.           you to complete the search procedure. This option allows you to
  1449.           search for a particular word in a title, chapter, authors name
  1450.           and so on. Try searching for the fictitious journal article you
  1451.           typed in. Select one of the words in that title, for example
  1452.           "the" and type:
  1453.  
  1454.                "the<Enter><Enter><Enter>"
  1455.  
  1456.                The program will search for a book reference with the given
  1457.           word in the title. The first reference it finds will be displayed
  1458.           on the screen. When there are several matching references in the
  1459.           database, you can use the <Pg Dn> key to look at other references
  1460.           which match the criteria you have given. The <Pg Up> key can be
  1461.           used to go back to a previous matching reference.
  1462.  
  1463.  
  1464.  
  1465.  
  1466.           BIBLOGIC                                                  Page 20
  1467.  
  1468.                                                                    Learning
  1469.  
  1470.  
  1471.                In this case the search will locate all of the book
  1472.           references with the word "the" in the title. The search will not
  1473.           take long because the database is small, but in a real database
  1474.           this would be quite slow and so this method of searching should
  1475.           be avoided except when absolutely necessary. The string of
  1476.           letters that you use in a search need not be a whole word. For
  1477.           example, you could use "hemip" to locate all of the references
  1478.           with the words "hemiplegic", "hemiplegia" or "hemiplegics" in the
  1479.           title.
  1480.  
  1481.                There are special features that can be used when completing
  1482.           editing searches. These are more fully explained in the reference
  1483.           section on page 58.
  1484.  
  1485.           2.4.6. Examining a reference
  1486.  
  1487.                The Examine option is located on both the Book and Article
  1488.           menus. It allows you to find a particular reference, or browse
  1489.           through similar references. You should use this option if you
  1490.           want to look at records, but do not want to alter the existing
  1491.           information. If you have an ASCII printer connected to LPT1 you
  1492.           can print out a hard copy of the current reference being examined
  1493.           on screen. This is done by pressing <Shift PrtSc> when the
  1494.           printer is turned on and the reference is displayed on the
  1495.           screen.
  1496.  
  1497.           2.4.7. Generating a reference list
  1498.  
  1499.                Before you can try out the process of producing a list of
  1500.           references, you must input some more references and reviews. Type
  1501.           in at least four or five more fictitious references and put in
  1502.           reviews for them (using arbitrary topic codes, for example
  1503.           "1234567890").
  1504.  
  1505.                At the main BIBLOGIC menu select the LISTS menu. The options
  1506.           on the LISTS menu are:
  1507.  
  1508.                          1. References
  1509.                          2. Comments with number
  1510.                          3. Comments with authors
  1511.                          4. Comments with reference
  1512.                          5. Journals
  1513.                          6. Manual list
  1514.  
  1515.                From these options you can see that there are several types
  1516.           of lists which can be generated. The most commonly created list
  1517.           is that of properly formatted references. Reference lists are the
  1518.           most complex lists because they require specific search
  1519.           procedures and special print formats. The format used for the
  1520.           reference is determined by the currently selected print format
  1521.  
  1522.  
  1523.  
  1524.  
  1525.           BIBLOGIC                                                  Page 21
  1526.  
  1527.                                                                    Learning
  1528.  
  1529.  
  1530.           file. Practice generating a reference list now. To enable you to
  1531.           do this an example journal title list and print format file were
  1532.           provided when the program was installed.
  1533.  
  1534.                To generate a reference list press <1> to select the
  1535.           reference option. To search for the references which are included
  1536.           in the list the program uses a "topic" code. The topic codes are
  1537.           assigned to the references when reviews are added. Hence, only
  1538.           references which have reviews added can be listed.
  1539.  
  1540.                When the Reference option is selected, you must provide a
  1541.           "topic", a number to start numbering from, and a name for the
  1542.           output file. In this example select topic "**********" by
  1543.           pressing <Enter>. To select an un-numbered list type <0> in the
  1544.           "number from" field. You should call the output file TEST. The
  1545.           file extension ".TXT" will be automatically added. When you press
  1546.           <Enter> you will see a series of messages describing the
  1547.           progression of the listing. Ultimately you will see some
  1548.           formatted references on the screen.
  1549.  
  1550.                Once the list has been created press <Enter> to return to
  1551.           the LISTS menu. Select the Exit option on the MAIN menu to exit
  1552.           from BIBLOGIC and return to DOS. At the DOS prompt type:
  1553.  
  1554.                "TYPE TEST.TXT<Enter>"
  1555.  
  1556.                You will see that this file contains the references which
  1557.           you typed in. At this stage DO NOT try to edit the file with your
  1558.           word processor. You will need to read the supplement at the back
  1559.           of the manual (regarding using BIBLOGIC with various word
  1560.           processors) before doing this.
  1561.  
  1562.                A comprehensive explanation of the different list options is
  1563.           provided in the reference section on page 66.
  1564.  
  1565.           2.4.8. Modifying the format of references
  1566.  
  1567.                You will see that the references which have been produced
  1568.           are in a consistent format, with the name and initials laid out
  1569.           and punctuated in a particular way. If this is not the format you
  1570.           require for your own references, it can be altered.
  1571.  
  1572.                Start the BIBLOGIC program again. If you have forgotten how
  1573.           to do this see page 14. At the MAIN menu select the SET-UP menu.
  1574.           You will see a number of options which allow you to adjust
  1575.           (configure) the way the program works. These are:
  1576.  
  1577.  
  1578.  
  1579.  
  1580.  
  1581.  
  1582.  
  1583.  
  1584.           BIBLOGIC                                                  Page 22
  1585.  
  1586.                                                                    Learning
  1587.  
  1588.  
  1589.                               1. Configure
  1590.                               2. New journal list
  1591.                               3. Edit journal list
  1592.                               4. New database
  1593.                               5. New print format
  1594.                               6. Edit print format
  1595.                               7. Set numbers
  1596.                               8. Medline/DIALOG conversion
  1597.                               9. Exit from BIBLOGIC
  1598.  
  1599.                Select option 6 (Edit print format). When asked for a file
  1600.           name type:
  1601.  
  1602.                "EXAMPLE<Enter>"
  1603.  
  1604.           After a short pause, you will be shown an example of the way the
  1605.           names were printed in the sample file you just produced. In
  1606.           answer to "Do you want to change the name format?" type:
  1607.  
  1608.                "Y<Enter>"
  1609.  
  1610.           You will then be asked "Do you want the initials before the
  1611.           name?" type:
  1612.  
  1613.                "Y<Enter>"
  1614.  
  1615.           You will see the format of the example change, and you will be
  1616.           asked "Do you want the names to be entirely in CAPITALS ?" type:
  1617.  
  1618.                "Y<Enter>"
  1619.  
  1620.           You will see the example change again. You will then be asked
  1621.           further questions about the formatting of the reference. From now
  1622.           on, in answer to every question just press <Enter> to accept the
  1623.           current format.
  1624.  
  1625.                Ultimately you will reach the "SPECIAL EFFECTS USAGE"
  1626.           screen. Press <Pg Dn> once, or <Enter> repeatedly to accept the
  1627.           current values. The program will then complete the format file
  1628.           editing and return you to the SET-UP menu.
  1629.  
  1630.                Go to the LISTS menu and make another alphabetical listing
  1631.           of references, exactly as you did before. You don't really need
  1632.           to go out into DOS to "type" the file produced. If you watch the
  1633.           program as it lists the references on the screen you will see
  1634.           that the format of the names in the references has been changed.
  1635.  
  1636.                This concludes the tutorial section, now you are ready to
  1637.           start the process of preparing to input real references. It
  1638.           should be remembered that this tutorial section was aimed to
  1639.           INTRODUCE you to the basic concepts of the BIBLOGIC program. You
  1640.  
  1641.  
  1642.  
  1643.           BIBLOGIC                                                  Page 23
  1644.  
  1645.                                                                    Learning
  1646.  
  1647.  
  1648.           are encouraged to read the reference section of the manual
  1649.           carefully after coping adequately with the basics. Read the
  1650.           reference section before adding many references as there are
  1651.           other advanced aspects not covered in this introduction.
  1652.  
  1653.  
  1654.  
  1655.  
  1656.  
  1657.  
  1658.  
  1659.  
  1660.  
  1661.  
  1662.  
  1663.  
  1664.  
  1665.  
  1666.  
  1667.  
  1668.  
  1669.  
  1670.  
  1671.  
  1672.  
  1673.  
  1674.  
  1675.  
  1676.  
  1677.  
  1678.  
  1679.  
  1680.  
  1681.  
  1682.  
  1683.  
  1684.  
  1685.  
  1686.  
  1687.  
  1688.  
  1689.  
  1690.  
  1691.  
  1692.  
  1693.  
  1694.  
  1695.  
  1696.  
  1697.  
  1698.  
  1699.  
  1700.  
  1701.  
  1702.           BIBLOGIC                                                  Page 24
  1703.  
  1704.                                                          Category Structure
  1705.  
  1706.  
  1707.           3. DESIGNING THE CATEGORY STRUCTURE
  1708.  
  1709.                You will now need to design the coding scheme which you will
  1710.           use to categorize the references in your database. The process of
  1711.           designing this scheme is initially done on paper - without
  1712.           actually putting in any references.
  1713.  
  1714.           3.1. WHY USE A CATEGORY STRUCTURE ?
  1715.  
  1716.                The BIBLOGIC program stores references of books or journals
  1717.           in the order they are entered. You will not usually want to
  1718.           create a reference list in this order, and you will not usually
  1719.           want a list of all of the references in your database. Normally
  1720.           the program is used to compile lists of references which share a
  1721.           common topic, arranged in alphabetical order by author (although
  1722.           other types of lists are possible).
  1723.  
  1724.                To generate a text file containing a list of references
  1725.           pertaining to a particular topic, some method must be used to
  1726.           identify just the relevant references out of the whole database.
  1727.           BIBLOGIC allows you to use an alpha-numeric coding system to
  1728.           categorize references. The program can produce a list of
  1729.           references on a particular topic by searching for references
  1730.           marked with a particular code in the database.
  1731.  
  1732.                A reference is categorized by putting a "review" for it into
  1733.           the database. A review consists of an alpha-numeric code
  1734.           representing a category and (optionally) notes or comments on the
  1735.           reference.
  1736.  
  1737.                A review can be added immediately following the addition of
  1738.           a reference to the database, or at a later time from the REVIEWS
  1739.           menu. The BIBLOGIC program is set up to force you to add a review
  1740.           immediately after each reference is entered. You can set up the
  1741.           program so that it does not do this (see page 72), but since
  1742.           uncategorized references cannot be included in reference lists
  1743.           you would not normally set it up this way.
  1744.  
  1745.                A unique feature of BIBLOGIC is that more than one review
  1746.           can be added for any particular reference. This allows multiple
  1747.           categorization of articles that cover more than one topic or
  1748.           concept. For example, the method, instrumentation, and results of
  1749.           an experiment discussed in a reference may be categorized (and
  1750.           commented on) separately. This feature also allows two or more
  1751.           users to individually categorize the same reference in different
  1752.           ways. This will be explained further in the section on multiple
  1753.           users (see page 38).
  1754.  
  1755.  
  1756.  
  1757.  
  1758.  
  1759.  
  1760.  
  1761.           BIBLOGIC                                                  Page 25
  1762.  
  1763.                                                          Category Structure
  1764.  
  1765.  
  1766.           3.2. BIBLOGIC CATEGORY STRUCTURES
  1767.  
  1768.                Some reference systems use keywords to categorize
  1769.           references. This can present several problems which BIBLOGIC
  1770.           overcomes by using an alpha-numeric coding system.
  1771.  
  1772.                In a system using keywords, inconsistencies in spelling
  1773.           between authors, countries or languages can produce an incomplete
  1774.           reference list. Likewise a spelling error in the keyword or a
  1775.           reference title will result in not all references on that
  1776.           particular topic being located. Searching with AND OR
  1777.           combinations may produce a list of the references that you want.
  1778.           Unfortunately, in practice, this method often generates a list of
  1779.           too many references or ones that are not applicable. By using an
  1780.           alpha-numeric system, in which the hierarchy is defined, the
  1781.           relevant references can be selected easily.
  1782.  
  1783.                Some computerized cataloging systems used in libraries use
  1784.           keywords to categorize references. This allows a large number of
  1785.           people access to a wide variety of broad topics. Although this
  1786.           approach may be appropriate for a large library, it is not well
  1787.           suited to a personal reference collection. In such a collection,
  1788.           the user must have quick access to very specific topics, which
  1789.           are organized in a way that suits the user's particular area of
  1790.           study.
  1791.  
  1792.           3.3. TYPES OF CATEGORY STRUCTURES
  1793.  
  1794.                The alpha-numeric system used in this program can be
  1795.           implemented in a number of ways. Let us consider a basic method
  1796.           first.
  1797.  
  1798.           3.3.1. Hierarchical tree structures
  1799.  
  1800.                The simplest way to consider the alpha-numeric system is as
  1801.           a tree structure. This structure consists of a central topic
  1802.           which is progressively subdivided into a number of successively
  1803.           smaller topics (see Figure 3.1). Each time a topic is split into
  1804.           smaller areas it creates a new level of the tree. This process
  1805.           can be repeated several times. BIBLOGIC allows a maximum of ten
  1806.           tree levels. It is generally advisable to use the smallest number
  1807.           of levels possible rather than defining a very elaborate tree
  1808.           with unnecessary levels.
  1809.  
  1810.  
  1811.  
  1812.  
  1813.  
  1814.  
  1815.  
  1816.  
  1817.  
  1818.  
  1819.  
  1820.           BIBLOGIC                                                  Page 26
  1821.  
  1822.                                                          Category Structure
  1823.  
  1824.  
  1825.                                                   |--1 Nut-based
  1826.                                                   |
  1827.                          |--1 Vegetarian----------|--2 Cheese-based
  1828.                          |                        |
  1829.                          |                        |--3 Meat Substitutes
  1830.           --1 Recipes----|
  1831.                          |                        |--1 Poultry
  1832.                          |                        |
  1833.                          |--2 Non-vegetarian------|--2 Fish
  1834.                                                   |
  1835.                                                   |--3 Other
  1836.  
  1837.                                    Figure 3.1
  1838.  
  1839.                The digits (0 to 9) and alphabetical characters (A to Z) are
  1840.           used to label the branches at each level of the tree. Hence,
  1841.           BIBLOGIC allows a maximum number of thirty-six (36) subdivisions
  1842.           of each topic to form the next level. Thus a major topic can be
  1843.           divided into thirty-six subtopics, and each of these subtopics
  1844.           can be split into thirty-six "sub-subtopics", and so on.
  1845.           Potentially, there are a maximum of 36 to the power 10 topic
  1846.           codes available to categorize a reference (i.e. 3,650,000,000,000
  1847.           ,000). Although this limits the size of the tree structure, in
  1848.           practice this limitation is not a problem. To simplify the tree
  1849.           it is advisable that the minimum number of branches is used.
  1850.           Fewer combinations will facilitate easier classification of
  1851.           references in the reviews section. It is also advisable not to
  1852.           use zero (0) to label a branch as it is better reserved for a
  1853.           special function (more on this later).
  1854.  
  1855.                Throughout the following explanation, the term "digit" is
  1856.           used to mean "letter or digit" for simplicity.
  1857.  
  1858.                References on a particular topic are categorized by using
  1859.           the tree structure. A particular topic is numbered by listing the
  1860.           digits corresponding to its position in the tree, from left to
  1861.           right. The left-most digit represents the "branch" to take to get
  1862.           to the chosen topic at the highest level. The following digits in
  1863.           the code represent the branches taken at each successive level of
  1864.           the tree. The concept of a numeric tree structure is similar to
  1865.           the hierarchical system used to number the sections of this
  1866.           manual, as shown in the table of contents.
  1867.  
  1868.           3.3.2. Matrices
  1869.  
  1870.                A matrix is a tabular structure which consists of rows and
  1871.           columns as shown in Figure 3.2 below.
  1872.  
  1873.  
  1874.  
  1875.  
  1876.  
  1877.  
  1878.  
  1879.           BIBLOGIC                                                  Page 27
  1880.  
  1881.                                                          Category Structure
  1882.  
  1883.  
  1884.  
  1885.  
  1886.  
  1887.           DIET                Vegetarian   Non-Vegetarian    Special
  1888.           -----------------|--------------|--------------|--------------|
  1889.           Low Fat          |              |              |              |
  1890.           -----------------|--------------|--------------|--------------|
  1891.           Low Cholesterol  |              |              |              |
  1892.           -----------------|--------------|--------------|--------------|
  1893.           Low Salt         |              |              |              |
  1894.           -----------------|--------------|--------------|--------------|
  1895.  
  1896.                                    Figure 3.2
  1897.  
  1898.                The intersections of the rows and columns represent
  1899.           references that pertain to both of two topics. When designing
  1900.           your category structure you will often find that parts of your
  1901.           categorization divide more logically into a matrix representation
  1902.           rather than a tree.
  1903.  
  1904.                As you can see in Figures 3.3 and 3.4 below, this method of
  1905.           categorizing topics can still be represented as a tree structure,
  1906.           so the same numbering system can be used. The branching system
  1907.           used in each example achieves the same results but the layout of
  1908.           Figure 3.4 is simpler and more consistent than Figure 3.3.
  1909.  
  1910.                                                   |--1 Veg.
  1911.                                                   |
  1912.                          |--1 Low Fat-------------|--2 Non-Veg.
  1913.                          |                        |
  1914.                          |                        |--3 Special
  1915.                          |
  1916.                          |                        |--1 Non-Veg.
  1917.                          |                        |
  1918.                     -----|--2 Low Chol.-----------|--2 Special
  1919.                          |                        |
  1920.                          |                        |--3 Veg.
  1921.                          |
  1922.                          |                        |--1 Special
  1923.                          |                        |
  1924.                          |--3 Low Salt------------|--2 Veg.
  1925.                                                   |
  1926.                                                   |--3 Non-veg.
  1927.  
  1928.                                    Figure 3.3
  1929.  
  1930.  
  1931.  
  1932.  
  1933.  
  1934.  
  1935.  
  1936.  
  1937.  
  1938.           BIBLOGIC                                                  Page 28
  1939.  
  1940.                                                          Category Structure
  1941.  
  1942.  
  1943.                                                   |--1 Veg.
  1944.                                                   |
  1945.                          |--1 Low Fat-------------|--2 Non-Veg.
  1946.                          |                        |
  1947.                          |                        |--3 Special
  1948.                          |
  1949.                          |                        |--1 Veg.
  1950.                          |                        |
  1951.                     -----|--2 Low Chol.-----------|--2 Non-Veg.
  1952.                          |                        |
  1953.                          |                        |--3 Special
  1954.                          |
  1955.                          |                        |--1 Veg.
  1956.                          |                        |
  1957.                          |--3 Low Salt------------|--2 Non-Veg.
  1958.                                                   |
  1959.                                                   |--3 Special
  1960.  
  1961.                                    Figure 3.4
  1962.  
  1963.                In Figure 3.4 it can be seen that, at the third level, each
  1964.           branch is identical. Also, the order in which such levels are
  1965.           defined is arbitrary. That is to say, the first level could
  1966.           divide by type and the second level by diet, or vice versa. A
  1967.           simplified way of representing this structure is shown in Figure
  1968.           3.5.
  1969.  
  1970.                          |--1 Low Fat----|        |--1 Veg.------|
  1971.                          |               |        |              |
  1972.                      ----|--2 Low Chol.--|--------|--2 Non-Veg.--|----
  1973.                          |               |        |              |
  1974.                          |--3 Low Salt---|        |--3 Special---|
  1975.  
  1976.                                    Figure 3.5
  1977.  
  1978.                In a tree structure like that shown in Figure 3.1, the
  1979.           branches with the same number at a particular level are not
  1980.           necessarily related. In that example, topic 123 was no more
  1981.           related to 113 than it was to 112, in other words the "3" has no
  1982.           consistent significance across that level. On the other hand, in
  1983.           the matrix example, a digit has a consistent meaning across a
  1984.           whole level.
  1985.  
  1986.                You can see then, that the matrix structure is really just a
  1987.           special kind of tree structure. Most BIBLOGIC users find that
  1988.           their tree structure that they develop has some levels that
  1989.           represent a matrix (usually the first three or four levels) and
  1990.           some levels that represent a hierarchical tree. Besides the
  1991.           advantage of creating a logical and efficient categorization
  1992.           structure, the matrix structure also assists in minimizing the
  1993.  
  1994.  
  1995.  
  1996.  
  1997.           BIBLOGIC                                                  Page 29
  1998.  
  1999.                                                          Category Structure
  2000.  
  2001.  
  2002.           tree structure's depth. The benefit of creating such a combined
  2003.           category structure (such as that shown in Figure 3.6) will be
  2004.           explained in the next section.
  2005.  
  2006.  
  2007.  
  2008.                                                        |--1 Nut-based
  2009.                                                        |
  2010.                                         |--1 Veg.------|--2 Cheese-based
  2011.                                         |              |
  2012.                                         |              |--3 Meat Subst.
  2013.                                         |
  2014.                   |--1 Low Fat----|     |              |--1 Poultry
  2015.                   |               |     |              |
  2016.                ---|--2 Low Chol.--|-----|--2 Non-Veg.--|--2 Fish
  2017.                   |               |     |              |
  2018.                   |--3 Low Salt---|     |              |--3 Other
  2019.                                         |
  2020.                                         |              |--1 Vegetable
  2021.                                         |              |
  2022.                                         |--3 Special---|--2 Tofu
  2023.                                                        |
  2024.                                                        |--3 Pulses
  2025.  
  2026.                                    Figure 3.6
  2027.  
  2028.  
  2029.  
  2030.  
  2031.  
  2032.  
  2033.  
  2034.  
  2035.  
  2036.  
  2037.  
  2038.  
  2039.  
  2040.  
  2041.  
  2042.  
  2043.  
  2044.  
  2045.  
  2046.  
  2047.  
  2048.  
  2049.  
  2050.  
  2051.  
  2052.  
  2053.  
  2054.  
  2055.  
  2056.           BIBLOGIC                                                  Page 30
  2057.  
  2058.                                                          Category Structure
  2059.  
  2060.  
  2061.           3.4. HOW TO DESIGN A CUSTOMIZED CATEGORY STRUCTURE
  2062.  
  2063.                This section describes how to create a category structure
  2064.           for first time users of BIBLOGIC. In this manual, the term "topic
  2065.           label" is used to describe the heading given to any division of
  2066.           the category structure. The term "topic code" refers to the
  2067.           alpha-numeric code that represents a topic label. The terms
  2068.           Recipes, Vegetarian and Nut-based are examples of topic labels
  2069.           used in the category structure on page 30. Considerable thought
  2070.           should be given to the terminology used for topic labels. They
  2071.           should be as descriptive and as specific as possible in order to
  2072.           accurately define the concept they encompass. Obviously the topic
  2073.           labels will become more specific the deeper they are located in
  2074.           the category structure.
  2075.  
  2076.                To devise your own category structure, begin by writing a
  2077.           list of the major topic areas that are of interest to you. The
  2078.           categories chosen initially should be broad and nonspecific. Once
  2079.           these broad topic areas are established they can be subdivided
  2080.           into more specific topics. At first, it may not be clear where
  2081.           some topics that you want to include fit into the structure,
  2082.           whereas the relationships between other topics will be clear-cut.
  2083.           Reassess these major topics regularly, as you may find that these
  2084.           initial topic areas may not make up the final top levels of the
  2085.           structure. You will find that they can often be re-categorized
  2086.           under a even broader topic (see Figure 3.7 below).
  2087.  
  2088.                                                             |--1 Nut-based
  2089.                                                             |
  2090.                                               |--1 Veg.-----|--2 Cheese-b.
  2091.                                               |             |
  2092.                                               |             |--3 Meat Sub.
  2093.                                               |
  2094.                             |--1 Low Fat----| |             |--1 Poultry
  2095.             |--1 Metric---| |               | |             |
  2096.           --|             |-|--2 Low Chol.--|-|--2 Non-Veg.-|--2 Fish
  2097.             |--2 Imperial-| |               | |             |
  2098.                             |--3 Low Salt---| |             |--3 Other
  2099.                                               |
  2100.                                               |             |--1 Vegetable
  2101.                                               |             |
  2102.                                               |--3 Special--|--2 Tofu
  2103.                                                             |
  2104.                                                             |--3 Pulses
  2105.  
  2106.                                    Figure 3.7
  2107.  
  2108.                It is a good idea to leave space to allow for the addition
  2109.           of further topic categories as they are required or come to mind.
  2110.           However, you should try to minimize the overall complexity of the
  2111.           category structure.
  2112.  
  2113.  
  2114.  
  2115.           BIBLOGIC                                                  Page 31
  2116.  
  2117.                                                          Category Structure
  2118.  
  2119.  
  2120.  
  2121.                Do not be too concerned about adhering to traditional
  2122.           methods of categorizing topics within your area of interest. If,
  2123.           for example, it suits your study to categorize flowers as, say,
  2124.           either scented or unscented, then this should be done rather than
  2125.           using traditional botanical categories.
  2126.  
  2127.                The structure initially developed will often contain areas
  2128.           where there is obvious repetition. This is usually indicative of
  2129.           an underlying matrix structure and you should consider whether
  2130.           matrix levels can be used to streamline the structure. This is
  2131.           similar to the process that was used to simplify the category
  2132.           structure in Figure 3.4 to get Figure 3.5. Often, it will be
  2133.           convenient to use the first few levels of your structure as
  2134.           matrix levels, although they need not necessarily be the first
  2135.           levels.
  2136.  
  2137.                The emphasis, in the initial stages of category structure
  2138.           development, should be on experimentation with different
  2139.           combinations of topics and the order of subdivision.
  2140.  
  2141.                When first designing a category structure, users often
  2142.           create a very elaborate structure with levels nested
  2143.           unnecessarily deep. In the example shown in Figure 3.8, the
  2144.           structure shown in (a) may be rearranged as shown in (b). In (a),
  2145.           the user will be able to select references pertaining to the use
  2146.           of a particular statistical test on a particular animal (for
  2147.           example, by choosing the code for "...Breeding-Sheep-Statistics
  2148.           -Parametric-Anova..."). In practice however, if the user knows
  2149.           that they will be unlikely to be interested in singling out
  2150.           statistics-related references by animal, then the structure shown
  2151.           in (b) will be quite adequate.
  2152.  
  2153.                It may at first seem strange to have a mutually exclusive
  2154.           choice of Pigs, Sheep, Cattle or Statistics at one level. One
  2155.           might ask "How do I categorize an article which is specifically
  2156.           about pigs and uses a particular type of statistics ?". Of
  2157.           course, the answer is that the article should be categorized
  2158.           twice (by putting in two reviews), once as a "piggy" reference
  2159.           and once as a statistics reference.
  2160.  
  2161.                The argument put forward above can be taken a step further.
  2162.           If the user has no reason to distinguish between statistical
  2163.           techniques used to study breeding and those related to feeding,
  2164.           then the first level can be a choice of Breeding, Feeding or
  2165.           Statistics, and the whole statistics branch can be moved another
  2166.           level as shown in (c).
  2167.  
  2168.  
  2169.  
  2170.  
  2171.  
  2172.  
  2173.  
  2174.           BIBLOGIC                                                  Page 32
  2175.  
  2176.                                                          Category Structure
  2177.  
  2178.  
  2179.  
  2180.  
  2181.  
  2182.  
  2183.  
  2184.                                                        |-Parametric-|
  2185.                               |-Pigs---|  |-Statistics-|
  2186.                  |-Breeding-| |        |  |            |-Non-param.-|
  2187.                --|          |-|-Sheep--|--|
  2188.                  |-Feeding--| |        |  |
  2189.                               |-Cattle-|  |-Experimental Design
  2190.  
  2191.                                              (a)
  2192.  
  2193.  
  2194.  
  2195.                                    |-Pigs---|
  2196.                       |-Breeding-| |        |
  2197.                     --|          |-|-Sheep--|--
  2198.                       |-Feeding--| |        |
  2199.                                    |-Cattle-|
  2200.                                    |            |-Parametric-|
  2201.                                    |-Statistics-|
  2202.                                                 |-Non-Param.-|
  2203.  
  2204.                                              (b)
  2205.  
  2206.  
  2207.  
  2208.                                         |-Pigs---|
  2209.                            |-Breeding-| |        |
  2210.                          --|          |-|-Sheep--|--
  2211.                            |-Feeding--| |        |
  2212.                            |            |-Cattle-|
  2213.                            |
  2214.                            |
  2215.                            |            |-Parametric-|
  2216.                            |-Statistics-|
  2217.                                         |-Non-Param.-|
  2218.  
  2219.                                              (c)
  2220.  
  2221.  
  2222.  
  2223.                                    Figure 3.8
  2224.  
  2225.  
  2226.  
  2227.  
  2228.  
  2229.  
  2230.  
  2231.  
  2232.  
  2233.           BIBLOGIC                                                  Page 33
  2234.  
  2235.                                                          Category Structure
  2236.  
  2237.  
  2238.                If possible, you should not use all of the ten available
  2239.           levels in your tree design, so that there is room for expansion
  2240.           of the tree at a later date. Think carefully about your structure
  2241.           as it develops, and reassess your approach frequently to pick up
  2242.           this problem. An unnecessarily deep tree usually results from
  2243.           losing sight of the purpose of the tree structure, which is to
  2244.           categorize references so that particular topics can be located,
  2245.           rather than to split up your area of interest wherever a
  2246.           distinction COULD be made.
  2247.  
  2248.                Obviously the opposite problem can occur. A tree with a
  2249.           total of only, say, ten categories will be unlikely to provide
  2250.           the flexibility required when making lists unless only very few
  2251.           references are being categorized.
  2252.  
  2253.                It can be useful to write your topic labels on cards, so
  2254.           that you can spread them out and rearrange them easily.
  2255.           Alternatively draw your structure on large sheets of paper so
  2256.           that you can more easily see the relationships between topics. As
  2257.           you work through this process your own logical category structure
  2258.           with its subdivisions will emerge.
  2259.  
  2260.                To start testing your category structure, select a
  2261.           particular type of reference and work through the structure to
  2262.           check that the reference can be distinctly categorized. By doing
  2263.           this, you can ensure that your topic codes are specific enough to
  2264.           allow accurate categorization of your references. Repeat this a
  2265.           number of times, tracing a number of branches to thoroughly test
  2266.           your structure. Remember that you will normally categorize
  2267.           references more than once (when they address more than one
  2268.           concept) by entering more than one review for each reference.
  2269.  
  2270.                If you find it difficult to categorize your references
  2271.           within the structure it may be too narrow and specific. If this
  2272.           is the case further expansion of categories is needed. On the
  2273.           other hand, if you can easily categorize references, the
  2274.           structure may not be sufficiently specific. A balance between the
  2275.           two is ideal.
  2276.  
  2277.                At all times ask yourself the question: "What sort of
  2278.           references would I need to be able to list, and what topic code
  2279.           would I use to get just these references".
  2280.  
  2281.                The next step is to designate the topic codes for your
  2282.           structure. This is achieved by labeling the branches of your tree
  2283.           with a letter of the alphabet or a digit from 0 to 9. The letters
  2284.           and numbers can be assigned arbitrarily, or you may like to
  2285.           choose letters that help you remember the label represented (for
  2286.           example M for Male and F for Female). When possible, try to avoid
  2287.           using letters or numbers that can be confused with each other
  2288.           (for example 1 and I, O and 0 or 2 and Z) at the same level.
  2289.  
  2290.  
  2291.  
  2292.           BIBLOGIC                                                  Page 34
  2293.  
  2294.                                                          Category Structure
  2295.  
  2296.  
  2297.  
  2298.                As well as having a diagram of your tree structure (which
  2299.           inevitably develops as you design the structure), it is advisable
  2300.           to keep a written copy of your category structure in a book or
  2301.           folder. A suggested page layout is shown in Figure 3.9. Each page
  2302.           of the book should represent a different level of the category
  2303.           structure. It is most appropriate for the higher levels of the
  2304.           category structure to be positioned at the front of the book. The
  2305.           topic subdivisions and accompanying codes are listed under the
  2306.           relevant level.
  2307.  
  2308.  
  2309.  
  2310.  
  2311.  
  2312.  
  2313.  
  2314.  
  2315.  
  2316.  
  2317.  
  2318.  
  2319.  
  2320.  
  2321.  
  2322.  
  2323.  
  2324.  
  2325.  
  2326.  
  2327.  
  2328.  
  2329.  
  2330.  
  2331.  
  2332.  
  2333.  
  2334.  
  2335.  
  2336.  
  2337.  
  2338.  
  2339.  
  2340.  
  2341.  
  2342.  
  2343.  
  2344.  
  2345.  
  2346.  
  2347.  
  2348.  
  2349.  
  2350.  
  2351.           BIBLOGIC                                                  Page 35
  2352.  
  2353.                                                          Category Structure
  2354.  
  2355.  
  2356.  
  2357.  
  2358.  
  2359.  
  2360.  
  2361.  
  2362.  
  2363.  
  2364.           |------------------|               |------------------|
  2365.           | Page 1 (Level 1) |               | Page 4 (Level 4) |
  2366.           |                  |               |                  |
  2367.           | 1 Metric    Pg 2 |               | 1 Nut-based      |
  2368.           | 2 Imperial  Pg 2 |               | 2 Cheese-based   |
  2369.           |                  |               | 3 Meat Subst.    |
  2370.           |    |------------------|          |         |------------------|
  2371.           |    | Page 2 (Level 2) |          |         | Page 6 (Level 4) |
  2372.           |    |                  |          |         |                  |
  2373.           |    | 1 Low Fat   Pg 3 |          |         | 1 Vegetable      |
  2374.           |----| 2 Low Chol. Pg 3 |          |---------| 2 Tofu           |
  2375.                | 3 Low Salt  Pg 3 |                    | 3 Pulses         |
  2376.                |    |------------------|     |------------------|         |
  2377.                |    | Page 3 (Level 3) |     | Page 5 (Level 4) |         |
  2378.                |    |                  |     |                  |         |
  2379.                |    | 1 Veg.      Pg 4 |     | 1 Poultry        |         |
  2380.                |----| 2 Non-Veg.  Pg 5 |     | 2 Fish           |---------|
  2381.                     | 3 Special   Pg 6 |     | 3 Other          |
  2382.                     |                  |     |                  |
  2383.                     |                  |     |                  |
  2384.                     |                  |     |                  |
  2385.                     |                  |     |                  |
  2386.                     |------------------|     |------------------|
  2387.  
  2388.                                    Figure 3.9
  2389.  
  2390.  
  2391.  
  2392.  
  2393.  
  2394.  
  2395.  
  2396.  
  2397.  
  2398.  
  2399.  
  2400.  
  2401.  
  2402.  
  2403.  
  2404.  
  2405.  
  2406.  
  2407.  
  2408.  
  2409.  
  2410.           BIBLOGIC                                                  Page 36
  2411.  
  2412.                                                          Category Structure
  2413.  
  2414.  
  2415.  
  2416.                When transcribing the category structure to the book you
  2417.           will find that, due to the complexity of most category
  2418.           structures, the category subdivisions will not necessarily be
  2419.           able to follow on successive pages. This problem is overcome by
  2420.           using a referral system. The right hand column is used to refer
  2421.           to the next level of categorization and the page on which it is
  2422.           located. This is especially important if matrices are
  2423.           incorporated in the category structure.
  2424.  
  2425.                BIBLOGIC allows the you to display notes on your category
  2426.           structure on-screen. It is not essential to do this, but some
  2427.           users find it helpful. The notes are stored in a special text
  2428.           file (see page 99). The notes are displayed if you press the
  2429.           function key <F1> whenever the cursor is in a topic field (for
  2430.           example in a review or when typing in the topic code for a list).
  2431.  
  2432.  
  2433.                Once you are satisfied with the basic layout of your
  2434.           category structure, the next step is to input a small number of
  2435.           references and reviews (for example 20) using your topic codes.
  2436.           The next section of the manual shows you how to start to put in
  2437.           real references. If possible, the references should cover a wide
  2438.           variety of topics as this enables more comprehensive testing. To
  2439.           test your structure, try to produce lists of particular types of
  2440.           references that are included in your small database. This
  2441.           procedure helps you to identify and correct mistakes in the
  2442.           structure before you have entered hundreds of references and
  2443.           reviews. When you have successfully completed this test, add more
  2444.           reviews. When approximately one hundred reviews have been entered
  2445.           in the database, repeat the testing procedure.
  2446.  
  2447.                Note that, although BIBLOGIC has facilities for making bulk
  2448.           changes to the topic codes in a database (see page 84), these
  2449.           facilities are somewhat limited and should not be relied upon to
  2450.           make major reorganizations to your structure.
  2451.  
  2452.  
  2453.  
  2454.  
  2455.  
  2456.  
  2457.  
  2458.  
  2459.  
  2460.  
  2461.  
  2462.  
  2463.  
  2464.  
  2465.  
  2466.  
  2467.  
  2468.  
  2469.           BIBLOGIC                                                  Page 37
  2470.  
  2471.                                                          Category Structure
  2472.  
  2473.  
  2474.           3.5. CATEGORY STRUCTURES FOR PARTICULAR CIRCUMSTANCES
  2475.  
  2476.                In practice, there are certain situations that warrant
  2477.           special consideration when designing a category structure. In the
  2478.           following examples, it can be seen that the categorization and
  2479.           coding of references need not relate only to topics. The category
  2480.           structure can be utilized to divide references up for a variety
  2481.           of purposes.
  2482.  
  2483.           3.5.1. Multiple users
  2484.  
  2485.                If several people are intending to share the database it may
  2486.           be useful to separate their references or the comments they put
  2487.           into the reviews database. To do this one of the digits in the
  2488.           topic code can be used to distinguish between people. A user can
  2489.           then list only their own comments or references by selecting the
  2490.           correct digit, or everybody's comments by selecting "*". Which
  2491.           column of the code is chosen for this purpose is unimportant,
  2492.           because it is using a matrix form of categorization. Usually it
  2493.           will be less confusing to use either the left-most or right-most
  2494.           digit of the topic code.
  2495.  
  2496.                Of course, if multiple users are to share a database, the
  2497.           category structure has to be agreed upon between them.
  2498.  
  2499.           3.5.2. Chapters
  2500.  
  2501.                If you are writing a thesis or book you may already have
  2502.           ideas about how it is going to be split up into chapters. In this
  2503.           case it may be advantageous to use one digit of the
  2504.           categorization code to mark references with a chapter number. You
  2505.           will then be able to list comments in an appropriate grouping for
  2506.           assimilation into the body of the text using a word processor.
  2507.  
  2508.                Note that, it is being suggested here that you use a digit
  2509.           to represent the chapter in each review AS WELL as categorizing
  2510.           by topic. Hence a review might be categorized with the code
  2511.           "3X41H" where the "3" represents Chapter 3 and "X41H" represents
  2512.           a particular topic.
  2513.  
  2514.                Because of the somewhat indistinct boundaries between
  2515.           chapters, this approach will almost certainly diminish in
  2516.           usefulness as the project goes on but, providing you have spare
  2517.           digits in the topic code, this may be a useful scheme. Asterisks
  2518.           can be used to ignore this categorization in searches if
  2519.           required. In our example above, we might initially find searches
  2520.           for "3*********" useful, but we might later only ever search for
  2521.           "*X41H*****" or "*X4*******".
  2522.  
  2523.  
  2524.  
  2525.  
  2526.  
  2527.  
  2528.           BIBLOGIC                                                  Page 38
  2529.  
  2530.                                                          Category Structure
  2531.  
  2532.  
  2533.           3.5.3. Critical dates
  2534.  
  2535.                When categorizing references, you may find it useful to
  2536.           categorize a reference with respect to a certain date or event.
  2537.           This is useful if there is some distinct event in the history of
  2538.           the subject that you are studying which affects the usefulness of
  2539.           your references. If one digit of your categorization code
  2540.           signifies, for example, "B" for "before the revolution" or "A"
  2541.           for "after or during the revolution", you can use this to select
  2542.           useful references.
  2543.  
  2544.                Of course, this technique is not limited to historians. It
  2545.           can be used to distinguish between the publication of a
  2546.           significant paper which affects your subject, or an International
  2547.           Standard which makes results easier to compare after a certain
  2548.           date.
  2549.  
  2550.           3.5.4. Marking references
  2551.  
  2552.                The topic coding of references can be used for marking
  2553.           articles for a variety of purposes. These may include tagging
  2554.           references:
  2555.  
  2556.                     by course code
  2557.                     for inclusion in a particular reading list
  2558.                     which are entered into the database temporarily
  2559.                     which have been read or not.
  2560.                     by type (If you have a lot of references that are not
  2561.                     chapters in books or journal articles).
  2562.  
  2563.           3.5.5. Zero as a topic code
  2564.  
  2565.                As mentioned earlier, it is recommended that "0" is not used
  2566.           to define a topic label level if possible. This enables "0" to be
  2567.           used to label any level as "uncategorized" or "other category".
  2568.           This is particularly useful when the structure consists of many
  2569.           matrix levels, which gives a simple structure but may mean that
  2570.           certain levels are not applicable to some references.
  2571.  
  2572.           3.5.6. Other uses
  2573.  
  2574.                Users preparing a major thesis could use one digit of the
  2575.           code to categorize every reference as either "used" or "not used"
  2576.           in the thesis. This will allow references to be excluded from
  2577.           lists even when their topic, chapter number and so on are
  2578.           appropriate. A variation on this idea is to use a "fake" chapter
  2579.           number for the same purpose (assuming a topic digit is already
  2580.           being used for chapter number).
  2581.  
  2582.  
  2583.  
  2584.  
  2585.  
  2586.  
  2587.           BIBLOGIC                                                  Page 39
  2588.  
  2589.                                                          Category Structure
  2590.  
  2591.  
  2592.                Some users will like to put some sort of review into the
  2593.           database as soon as the reference has been input, but leave
  2594.           actually reading and commenting on the item until later. In this
  2595.           case it may be useful to be able to call up items which have not
  2596.           been fully reviewed. A topic digit could be used to indicate that
  2597.           a review is incomplete.
  2598.  
  2599.           3.5.7. Partial categorization
  2600.  
  2601.                If it is still unclear as to the best approach to categorize
  2602.           your references, it is possible to initially define only part of
  2603.           the structure (maybe only three or four levels) and to "tighten
  2604.           up" the categorization later. Reviews can be edited to
  2605.           incorporate further categorization when the final structure is
  2606.           designed. However it is recommended that you fully design your
  2607.           category structure before adding many references and reviews, so
  2608.           that it is not necessary to go back and edit a large number of
  2609.           topic codes at a later date.
  2610.  
  2611.  
  2612.  
  2613.  
  2614.  
  2615.  
  2616.  
  2617.  
  2618.  
  2619.  
  2620.  
  2621.  
  2622.  
  2623.  
  2624.  
  2625.  
  2626.  
  2627.  
  2628.  
  2629.  
  2630.  
  2631.  
  2632.  
  2633.  
  2634.  
  2635.  
  2636.  
  2637.  
  2638.  
  2639.  
  2640.  
  2641.  
  2642.  
  2643.  
  2644.  
  2645.  
  2646.           BIBLOGIC                                                  Page 40
  2647.  
  2648.                                                         Creating A Database
  2649.  
  2650.  
  2651.           4. CREATING YOUR OWN REFERENCE DATABASE
  2652.  
  2653.           4.1. PREPARING TO INPUT REAL REFERENCES
  2654.  
  2655.                So far, in learning how to use the BIBLOGIC program you have
  2656.           entered some fictitious example references and reviews. These
  2657.           have been stored in a database called "EXAMPLE". This section
  2658.           describes how to go about entering real references. Before doing
  2659.           this you will need to create a new database, journal list and
  2660.           print format file and set up BIBLOGIC to use these new files. New
  2661.           files can be produced using the options on the SET-UP menu.
  2662.  
  2663.                During the installation process, appropriate blank files
  2664.           (which were provided in the installation package) were copied
  2665.           over to your hard disk. If you are not already at the BIBLOGIC
  2666.           MAIN menu return to it now. From there exit to DOS. Now, you will
  2667.           run a "Batch" file which will copy some empty databases and other
  2668.           control files for you to use. At the DOS prompt type:
  2669.  
  2670.                "GOREAL<Enter>"
  2671.  
  2672.                The examples that you previously typed in will now be
  2673.           discarded and the program will be set up to use the following
  2674.           files:
  2675.  
  2676.                Database:                DATABASE
  2677.                Journal List:            JOURNALS
  2678.                Print Format:            PRINTFOR
  2679.  
  2680.                The database and journal list are empty and the print format
  2681.           file defines a simple format without "special effects codes".
  2682.  
  2683.           4.1.1. Making a list of journals
  2684.  
  2685.                To prepare to input your own references, you first need to
  2686.           compile a list of at least some of the journal titles that you
  2687.           expect to encounter. If you do not already have an existing
  2688.           referencing system, such as a card index, you may find it best to
  2689.           first compile a list of journal titles on paper and then number
  2690.           them. If you do have an existing system you can enter these
  2691.           directly into the program. It does not matter if you do not have
  2692.           a complete list at this stage. As your database expands, you can
  2693.           add to the journal list.
  2694.  
  2695.                The program allows you to print out your journal list either
  2696.           alphabetically or in numerical order. Most users use the
  2697.           alphabetical listing when entering references and the number
  2698.           assigned to each journal is, to all intents and purposes,
  2699.           arbitrary. If your database includes a wide variety of journals
  2700.           you may find it useful to group the journals by subject area or
  2701.           source. For example, all journals relating to Surgery could be
  2702.  
  2703.  
  2704.  
  2705.           BIBLOGIC                                                  Page 41
  2706.  
  2707.                                                         Creating A Database
  2708.  
  2709.  
  2710.           within the journal numbers 40-60. When using such a technique it
  2711.           is best to leave suitable space (unused journal numbers) for
  2712.           later additions. Printing out a journal list is described on page
  2713.           43.
  2714.  
  2715.                There will be some references that you will wish to include
  2716.           in your database that are not actually either journal articles or
  2717.           chapters in books. Depending on the type of reference, these may
  2718.           be put in as if they are a chapter in a book or as if they are an
  2719.           article in a journal. It is probably best to deal with these
  2720.           references when you are more familiar with the program, but
  2721.           ultimately your "journal list" may contain some names that are
  2722.           not actually the titles of journals.
  2723.  
  2724.                An example of such a reference is a reference to a court
  2725.           case. Some users include the names of courts in their journal
  2726.           lists and find that they can get these references out in an
  2727.           appropriate format this way. Some users also enter Conference
  2728.           Proceedings in a similar way, although these can have editors and
  2729.           a publishing body associated with them and may fit in better as
  2730.           chapters in a book. If you have a lot of "problem references"
  2731.           which do not appear to readily fit the database, then you should
  2732.           try to resolve the problem at an early stage. If you have only a
  2733.           few such references you can deal with the normal references first
  2734.           and determine whether such references are included as articles in
  2735.           a "fake" journal or chapters in a "fake" book when you are more
  2736.           familiar with the ways that references are listed.
  2737.  
  2738.                To create your own new journal list you must first run the
  2739.           BIBLOGIC program. To do this type the following at the DOS
  2740.           prompt.
  2741.  
  2742.                 "BIBLOGIC<Enter>"
  2743.  
  2744.                When the BIBLOGIC MAIN menu appears on screen, go to the
  2745.           SET-UP menu options by pressing the <S> key (you could also use
  2746.           the right- or left-arrow keys to move across the menus to the
  2747.           SET-UP menu). Select option 3 (Edit journal list). This option
  2748.           allows you to change the contents of an existing journal list, in
  2749.           this case the empty one which was copied across during
  2750.           installation.
  2751.  
  2752.                Since "JOURNALS.JLS" is currently empty, you will need to
  2753.           input the names and numbers of the journals into this file. When
  2754.           asked for the name of the list to edit type "JOURNALS<Enter>".
  2755.           You will then be asked if you want the journals in alphabetical
  2756.           order, answer "Y". If, in the future, you want to edit the list
  2757.           in numerical order simply select "N" when asked.
  2758.  
  2759.  
  2760.  
  2761.  
  2762.  
  2763.  
  2764.           BIBLOGIC                                                  Page 42
  2765.  
  2766.                                                         Creating A Database
  2767.  
  2768.  
  2769.                You will now see a screen with an editing window with arrows
  2770.           pointing to a line within the window. Above the window, the
  2771.           functions associated with various keys are listed. Press
  2772.           <F6> (Add) to add a journal and type the number and name of the
  2773.           journal into the box that appears. The journal title must be
  2774.           entered exactly as you want it to appear in references. Press
  2775.           <Enter> and you will see the journal copied into the box. Add
  2776.           further journals in the same way. You will see that the journals
  2777.           are added to the box in alphabetical order.
  2778.  
  2779.                If you are typing in new journals you will just use the Add
  2780.           function. However, if you want to make changes to the ones you
  2781.           have already typed in you can use the other functions. You can
  2782.           use the up- and down-arrow keys to move the list up and down a
  2783.           line at a time or the <Pg Up> and <Pg Dn> to move to the journal
  2784.           currently at the top or bottom of the box respectively. You may
  2785.           use the <F5> key to delete a journal title. The <F7> key can be
  2786.           used to find a particular journal title. If you want to edit the
  2787.           title at the arrows, press the <F8> key. To save the journal list
  2788.           when you have finished editing, press <Ctrl W>. Further
  2789.           instructions on editing the journal list appear on page 73.
  2790.  
  2791.           4.1.2. Printing the current journal list
  2792.  
  2793.                Although it is possible to bring up the journal list on the
  2794.           screen when you are adding or editing journal article references
  2795.           (see page 61), it is very useful to have a printed version of the
  2796.           list on hand. You can print out a list of journal titles in
  2797.           alphabetical or numeric order.
  2798.  
  2799.                At the MAIN menu, select the lists option to display its
  2800.           menu. Select option 5 on the LISTS menu to produce a list of the
  2801.           currently selected journal file. You will be asked whether you
  2802.           want the output file to have the journals listed alphabetically
  2803.           or numerically. The program will generate a list which is
  2804.           displayed on the screen as well as being stored on disk.
  2805.  
  2806.                The list which is written to the hard disk as a text file
  2807.           called "JOURNALS.ALP" if an alphabetical listing was selected or
  2808.           "JOURNALS.NMR" if a numeric listing was selected. This disk file
  2809.           can be printed out using the DOS "Print" command. If you are
  2810.           unsure how to do this check your DOS manual.
  2811.  
  2812.                It is possible to set up BIBLOGIC so that the lists made in
  2813.           this way are automatically directed to your printer as well as to
  2814.           disk (see page 72). In this case the printer must be turned on
  2815.           before you select the current journal list option.
  2816.  
  2817.  
  2818.  
  2819.  
  2820.  
  2821.  
  2822.  
  2823.           BIBLOGIC                                                  Page 43
  2824.  
  2825.                                                         Creating A Database
  2826.  
  2827.  
  2828.           4.2. INPUTTING REFERENCES
  2829.  
  2830.                It is necessary to have created your own topic category
  2831.           structure before inputting real references. You should do this
  2832.           because references entered without topic codes in reviews cannot
  2833.           be listed. This is fully explained in the section on "Designing A
  2834.           Category Structure" (see page 25). As well as this, you should
  2835.           have completed the tutorial section on inputting book and journal
  2836.           references (see page 14).
  2837.  
  2838.                If you have not completed either of these sections of the
  2839.           manual, you should refer to and complete these before continuing.
  2840.           It is also strongly recommended that, if you have not already
  2841.           done so, you run the demo program included in the release
  2842.           package. A batch file DEMO.BAT is included so you can just type
  2843.           "DEMO" at the DOS prompt in the BIBLOGIC directory to do this.
  2844.  
  2845.                If you have already completed these sections of the manual,
  2846.           and have defined a journal list, you can now go on to input real
  2847.           references into your database. The order in which you input the
  2848.           references is not important as they will be categorized by the
  2849.           topic codes.
  2850.  
  2851.           4.3. INPUTTING REVIEWS
  2852.  
  2853.                After a book or journal reference is put in, the program
  2854.           will force you to add a review. You can avoid putting in a review
  2855.           for the reference by pressing <Esc>.  However, unless a review is
  2856.           added, you will not be able to include the reference in any
  2857.           lists.
  2858.  
  2859.                To complete the review screen, first press <F3> and type
  2860.           some comments, as you did in the tutorial. Then press <F4> to
  2861.           return to the rest of the review and put in a topic code for the
  2862.           reference according to your category structure. It is not
  2863.           absolutely necessary to enter comments to use BIBLOGIC, but the
  2864.           programs usefulness is greatly enhanced by doing so. More than
  2865.           one topic code can be assigned to the reference by adding more
  2866.           reviews. The benefit of this is that the reference can be
  2867.           categorized a number of times to cover different topics. This
  2868.           allows you to find the reference when you are researching
  2869.           different areas, and to get lists of comments on a specific area
  2870.           (but about different references).
  2871.  
  2872.                Enter at least ten or twenty references (and corresponding
  2873.           reviews) now, so that you can experiment with the various listing
  2874.           options.
  2875.  
  2876.  
  2877.  
  2878.  
  2879.  
  2880.  
  2881.  
  2882.           BIBLOGIC                                                  Page 44
  2883.  
  2884.                                                         Creating A Database
  2885.  
  2886.  
  2887.           4.4. LISTS
  2888.  
  2889.                The LISTS menu option enables you to generate a text file
  2890.           consisting of references which are selected based on the topic
  2891.           codes, and formatted to the your specifications. It will also
  2892.           allow you to make a text file containing your comments based on
  2893.           topic codes.
  2894.  
  2895.                In the tutorial section (page 21), you used the LIST menu to
  2896.           make a list of any references that had reviews, now you can be
  2897.           specific about the sort of reference you want in the list. Select
  2898.           the "References option".
  2899.  
  2900.                When creating lists, you specify the type of references to
  2901.           be included in the list by providing a topic code. This topic
  2902.           code determines which references are to be included in the list.
  2903.           Asterisks (*) are used in search code to represent "don't care"
  2904.           or "all topics" at a particular level. For example, if you chose
  2905.           the topic code "123*******" the list generated would include all
  2906.           the references with the topics starting "123" with no regard for
  2907.           the other digits in the topic codes.
  2908.  
  2909.                An alternative to using a topic code to define the list is
  2910.           using a word (or part of a word) in the "search comments for"
  2911.           field. In this situation, the topic code will be ignored and a
  2912.           list consisting of references which have review comments
  2913.           containing the chosen word, will be created. Although this can be
  2914.           a useful way of producing lists under certain circumstances, it
  2915.           is not a very flexible method, and you should try to use your
  2916.           topic coding scheme instead whenever possible.
  2917.  
  2918.                Lists are formed from the combination of books and journal
  2919.           article references that fit the topic criteria of the search. If
  2920.           desired, only book or journal article references can be chosen by
  2921.           typing <B> or <J> in the "Books, Journal articles or All ?"
  2922.           field. The commonly used "reference list" option was covered in
  2923.           the tutorial section. Normally these references are
  2924.           alphabetically listed but may be listed in year order if desired.
  2925.  
  2926.                Try making a reference list now, as you did in the tutorial
  2927.           section (see page 21). This time use a real topic code to make a
  2928.           list of references on a particular topic.
  2929.  
  2930.                The lists you produce are written to an ASCII file. To make
  2931.           use of the list, you will need to read it into your word
  2932.           processor. Details of how to do this for various word processors
  2933.           are included in the supplement SUPPL.DOC. Basically, word
  2934.           processors can make use of these lists in one of three ways:
  2935.  
  2936.  
  2937.  
  2938.  
  2939.  
  2940.  
  2941.           BIBLOGIC                                                  Page 45
  2942.  
  2943.                                                         Creating A Database
  2944.  
  2945.  
  2946.           1)   Some can edit the file just as if it were a document which
  2947.                was created within the word processor itself.
  2948.  
  2949.           2)   Some require that you create an empty document of an
  2950.                appropriate format and read in the list using a "Read ASCII
  2951.                File", "Get File", "Block Insert" or "Import" function.
  2952.  
  2953.           3)   Some require that you run some sort of conversion routine on
  2954.                the file to convert it from raw ASCII to the correct format
  2955.                for the word processor. This might be done from a menu
  2956.                within the word processor or from DOS by running a special
  2957.                program.
  2958.  
  2959.                If you have put in any comments on the references, try out
  2960.           one or two of the comments list options from the LISTS menu.
  2961.           Lists can also be made in an arbitrary order determined by the
  2962.           user. Refer to the reference section for details of this and
  2963.           other list features (see page 70).
  2964.  
  2965.           4.5. MODIFYING THE PRINT FORMAT
  2966.  
  2967.                You can now experiment with the reference format in the
  2968.           lists you produce.
  2969.  
  2970.                The style or layout of a reference is determined by the
  2971.           print format. The print format also specifies the special codes
  2972.           that the BIBLOGIC program uses to relay printing instructions to
  2973.           your word processor, for example, for bold and underlined text.
  2974.  
  2975.                There are a number of special print format files, provided
  2976.           with the BIBLOGIC program, for commonly used word processors.
  2977.           These print format files contain specific print codes but you may
  2978.           find that you still need to modify the layout component of the
  2979.           file to meet your requirements.
  2980.  
  2981.                Since the print format supplied with the program will
  2982.           probably not suit your purposes, ultimately you will need to
  2983.           create a new format. For now, it is suggested that you leave the
  2984.           fine tuning of the print format until you are more familiar with
  2985.           the program. The following example shows you how to go about
  2986.           creating changes to the print format file if you find it
  2987.           necessary.
  2988.  
  2989.                Return to the MAIN menu and select the SET-UP menu. Choose
  2990.           option <5> to make a new print format file. You will be asked if
  2991.           you want to copy an existing print format file.
  2992.           Type:
  2993.  
  2994.                "Y<Enter>"
  2995.  
  2996.  
  2997.  
  2998.  
  2999.  
  3000.           BIBLOGIC                                                  Page 46
  3001.  
  3002.                                                         Creating A Database
  3003.  
  3004.  
  3005.           You will be provided with a list of existing file names. You will
  3006.           then need to supply a name of a file to copy from and a name to
  3007.           copy to. If one of the names listed corresponds to the word
  3008.           processor you use, select this name to copy FROM. The BIBLOGIC
  3009.           program is currently supplied with example print formats using
  3010.           special effects for a number of popular word processors. If you
  3011.           do not use one of these word processors type "PLAIN".
  3012.  
  3013.                You can name the new print format as you wish, but since the
  3014.           program is currently set up to use "PRINTFOR" it is best to use
  3015.           this name.
  3016.  
  3017.                As you will have seen in the tutorial section, the program
  3018.           will then prompt you with a series of questions that deal with
  3019.           the modification of the following parameters in layout and print
  3020.           code sections:
  3021.  
  3022.           Layout
  3023.  
  3024.                Name format
  3025.                Editors
  3026.                Punctuation separating parts of the reference
  3027.                Year format
  3028.                Publisher format
  3029.                Volume format
  3030.                Page format
  3031.                Notes format
  3032.  
  3033.           Print codes
  3034.  
  3035.                Special printing effects - definition
  3036.                Special printing effects - usage
  3037.  
  3038.                This time, look more closely at the questions that are asked
  3039.           about the format.
  3040.  
  3041.                When you do this, it is best if you have some references in
  3042.           front of you that are in the format that you are aiming to
  3043.           duplicate. Answer the print format questions as best you can but
  3044.           do not worry if you make some mistakes as you can go through this
  3045.           process again later. Note that, in some of the questions you must
  3046.           supply strings of characters. As you will want spaces in some of
  3047.           these strings, you must fill unused locations in the string with
  3048.           "#" which will be ignored by the program. This technique is used
  3049.           so that you can tell the difference between a "space" in the
  3050.           string and unused characters in the string.
  3051.  
  3052.                When you are asked if you want to change the special effects
  3053.           definitions answer:
  3054.  
  3055.                "N<Enter>"
  3056.  
  3057.  
  3058.  
  3059.           BIBLOGIC                                                  Page 47
  3060.  
  3061.                                                         Creating A Database
  3062.  
  3063.  
  3064.  
  3065.           The effects set up in the example will do for now. At the SPECIAL
  3066.           EFFECTS USAGE screen press <Pg Dn> to accept the current set-up.
  3067.           To modify these codes or to look at more specific details on
  3068.           modifying the print format refer to the reference section on page
  3069.           74. The reference section provides a step by step description and
  3070.           examples of these parameters.
  3071.  
  3072.                To try out the new print format, first check that the
  3073.           program is set up to use the right print format (PRINTFOR should
  3074.           be shown as the current print format on the MAIN menu), and then
  3075.           use the LISTS menu to make a reference list. If you have chosen
  3076.           to experiment with a print format with some other name, use the
  3077.           configure option on the SET-UP menu to change the current print
  3078.           format.
  3079.  
  3080.                Note that, when you have developed several print formats
  3081.           that produce the styles that you frequently use, you can use
  3082.           these formats simply by selecting the relevant print format file
  3083.           and making it the current one. You do NOT have to go through a
  3084.           lengthy question and answer session to define the format each
  3085.           time you want to make a list.
  3086.  
  3087.           4.6. DEVELOPING A BACKUP STRATEGY
  3088.  
  3089.                If you do not already have one, you should develop a
  3090.           strategy for protecting the data on your hard disk. The
  3091.           bibliographic database that you develop will be valuable to you
  3092.           and you will not wish to lose it ! Of course this is probably
  3093.           true for other data on your disk as well.
  3094.  
  3095.                At some time you will certainly lose some, or all of, the
  3096.           data on your hard disk. This is not just a possibility, it
  3097.           happens to everybody at some time. You should protect against the
  3098.           effects of losing your data by regularly copying the contents of
  3099.           your hard disk onto floppy disks or tape. To protect your
  3100.           reference database you should copy everything in the BIBLOGIC
  3101.           sub-directory onto floppy disks. Subsequent backups need only be
  3102.           of files which have changed.
  3103.  
  3104.                The DOS "Backup" program and similar utilities for backing
  3105.           up data can be made to back up only changed information by
  3106.           examining the "Archive" bit in the directory. This allows some
  3107.           interesting possibilities (see page 95). Consult your DOS manual
  3108.           for more information on the BACKUP utility, or contact a local
  3109.           software store for more information on alternative programs with
  3110.           similar functions.
  3111.  
  3112.  
  3113.  
  3114.  
  3115.  
  3116.  
  3117.  
  3118.           BIBLOGIC                                                  Page 48
  3119.  
  3120.                                                         Creating A Database
  3121.  
  3122.  
  3123.           4.7. ADVANCED FEATURES OF THE BIBLOGIC PROGRAM
  3124.  
  3125.                You have now familiarized yourself with the basic features
  3126.           of the program and you will be in a position to try some of the
  3127.           more advanced features. Browse through the reference section of
  3128.           the manual. The sections on the BOOKS, ARTICLES and REVIEWS menus
  3129.           contain some details not yet covered. The section on the LISTS
  3130.           menu describes the various methods of outputting information,
  3131.           which you should investigate.
  3132.  
  3133.                The most complicated part of the program, from the user's
  3134.           point of view is the SET-UP menu. You should read through the
  3135.           section on this menu so that you have an idea of how the
  3136.           program's behavior can, and cannot be altered.
  3137.  
  3138.           4.7.1. Specific features
  3139.  
  3140.                As you become more adept at using the BIBLOGIC database
  3141.           program you will be able to take advantage of the advanced
  3142.           features. Two of these are briefly described below. You should
  3143.           refer to the reference section to find information on the other
  3144.           features.
  3145.  
  3146.                1.   Import and Export of References (see page 83). The
  3147.                     BIBLOGIC program allows you to add the contents of one
  3148.                     database to another, or to output selected references
  3149.                     to form a separate database. In this way references can
  3150.                     be passed on to other BIBLOGIC users.
  3151.  
  3152.                2.   References captured during a session on some on-line
  3153.                     database services can be directly converted into a
  3154.                     BIBLOGIC database. (see page 80).
  3155.  
  3156.  
  3157.  
  3158.  
  3159.  
  3160.  
  3161.  
  3162.  
  3163.  
  3164.  
  3165.  
  3166.  
  3167.  
  3168.  
  3169.  
  3170.  
  3171.  
  3172.  
  3173.  
  3174.  
  3175.  
  3176.  
  3177.           BIBLOGIC                                                  Page 49
  3178.  
  3179.                                                                   Reference
  3180.  
  3181.  
  3182.           5. BIBLOGIC REFERENCE
  3183.  
  3184.                This section is arranged in a hierarchical fashion, in the
  3185.           same way that the menus themselves are arranged within the
  3186.           BIBLOGIC program.
  3187.  
  3188.           5.1. STARTING BIBLOGIC
  3189.  
  3190.                If you have installed BIBLOGIC using the install program as
  3191.           described on page 6 , then all you need to do is change the
  3192.           default drive to the correct disk (if necessary) by typing (for
  3193.           example):
  3194.  
  3195.           c:<Enter>
  3196.  
  3197.           then go to the BIBLOGIC directory by typing (for example):
  3198.  
  3199.           cd \biblogic<Enter>
  3200.  
  3201.           and then run BIBLOGIC by typing:
  3202.  
  3203.           biblogic<Enter>
  3204.  
  3205.           (You could write a batch file to do this if you like).
  3206.  
  3207.           If you want to install BIBLOGIC to run from subdirectories other
  3208.           than \BIBLOGIC, see the appendix on page 88.
  3209.  
  3210.                When BIBLOGIC is run, there will be a short delay while the
  3211.           main program is loaded from the disk. You will then see an
  3212.           information page giving copyright information. Read this page and
  3213.           then press <Enter> to continue. A few seconds later you will see
  3214.           the main menu.
  3215.  
  3216.                This page gives you access to all of the BIBLOGIC menus, as
  3217.           listed along the top line on the screen.
  3218.  
  3219.                The currently selected menu name (initially "Books") is
  3220.           highlighted, and below the name of the menu, the menu choices
  3221.           themselves appear. To access these menus you may use one of two
  3222.           methods to move the highlight from one menu name to another. You
  3223.           may use the left- and right-arrow keys to move through the menus
  3224.           or you may select a particular menu by pushing the letter
  3225.           corresponding to the first letter of the menu name (The EXIT menu
  3226.           may be reached by pressing <Esc>, as well as <E>).
  3227.  
  3228.                Once a menu has been chosen, the particular option required
  3229.           on that menu may be selected by moving the highlight within the
  3230.           menu to the required option with the up- and down-arrow keys. The
  3231.           item is then selected by pressing the <Enter> key. Alternatively,
  3232.  
  3233.  
  3234.  
  3235.  
  3236.           BIBLOGIC                                                  Page 50
  3237.  
  3238.                                                                   Reference
  3239.  
  3240.  
  3241.           the required item may be selected by pressing the number
  3242.           alongside the option (in this case you do not need to press
  3243.           <Enter> to select the item).
  3244.  
  3245.                Since the menus are selected by letters and the menu items
  3246.           by numbers, you can move freely around the options with very few
  3247.           keystrokes.
  3248.  
  3249.                As you move around the options in the various menus you will
  3250.           see a one-line description of what each option does, in the
  3251.           middle of the screen.
  3252.  
  3253.                At the bottom of the screen a box containing information
  3254.           about the current status of the program is displayed. This box
  3255.           tells you which database, which print format and which journal
  3256.           list are currently selected. On a registered copy of the program
  3257.           the name of the registered user also appears.
  3258.  
  3259.                The options on each menu are described below.
  3260.  
  3261.  
  3262.  
  3263.  
  3264.  
  3265.  
  3266.  
  3267.  
  3268.  
  3269.  
  3270.  
  3271.  
  3272.  
  3273.  
  3274.  
  3275.  
  3276.  
  3277.  
  3278.  
  3279.  
  3280.  
  3281.  
  3282.  
  3283.  
  3284.  
  3285.  
  3286.  
  3287.  
  3288.  
  3289.  
  3290.  
  3291.  
  3292.  
  3293.  
  3294.  
  3295.           BIBLOGIC                                                  Page 51
  3296.  
  3297.                                                                   Reference
  3298.  
  3299.  
  3300.           5.2. THE BOOKS MENU
  3301.  
  3302.           The options on the BOOKS menu are:
  3303.  
  3304.                               1. Add
  3305.                               2. Edit
  3306.                               3. Examine
  3307.  
  3308.           5.2.1. Add - Add new book references
  3309.  
  3310.                This option is used to put in bibliographic details on a
  3311.           book or a chapter in a book. When you select this option you will
  3312.           be provided with a new reference, with blank boxes (called
  3313.           "fields"), to fill in.
  3314.  
  3315.                Type the first author's name, <Enter>, initial <Enter>,
  3316.           initial <Enter>, initial <Enter>, second author's name, <Enter>
  3317.           and so on. Continue until you have put in all of the names. Press
  3318.           <Enter> without typing anything else to skip over unused
  3319.           initials. Press <Enter> instead of typing a surname to move on to
  3320.           the editors (see special features below).
  3321.  
  3322.                Repeat this process for the editors names, if there are any.
  3323.  
  3324.                Note that the first letter of the surname and the initials
  3325.           are automatically capitalized. You should ALWAYS type names with
  3326.           the <Caps Lock> OFF. This will allow you to ultimately print the
  3327.           names either in upper case or lower case, which will not be
  3328.           possible if you do not input the names in lower case. For the
  3329.           very few names which do not begin with a capital (e.g."deBurgh")
  3330.           start the name with a <Space> to avoid automatic capitalization
  3331.           of the first letter. The entry will be stored and displayed on
  3332.           the screen with a space in front of it, but when the reference is
  3333.           formatted for output to a word processor file any leading spaces
  3334.           in the surnames are removed.
  3335.  
  3336.                Names containing accents and other special characters create
  3337.           a special problem. Although your word processor may be able to
  3338.           cope with some of these, different word processors do this in
  3339.           different ways so it is difficult for BIBLOGIC to deal with them.
  3340.           Because of this problem you will need to edit the final list
  3341.           using your word processor. To allow you to find such names it is
  3342.           suggested that you add a "+" to the end of the name when you type
  3343.           it into BIBLOGIC. You may then use your word processor's find
  3344.           (locate) function to fix these before printing.
  3345.  
  3346.                The program will automatically assign a number to the
  3347.           reference (beginning with B1 for the first book reference). This
  3348.           number will be displayed below the publisher. This number should
  3349.           be noted on your copy of the reference so you can quickly access
  3350.           it when you need to. You may like to use these reference numbers
  3351.  
  3352.  
  3353.  
  3354.           BIBLOGIC                                                  Page 52
  3355.  
  3356.                                                                   Reference
  3357.  
  3358.  
  3359.           to file your copies of the articles. This way, when a reference
  3360.           is located on the computer, the paper copy of the actual
  3361.           reference can be found easily.
  3362.  
  3363.                Fill out the rest of the information, noting the following
  3364.           points:
  3365.  
  3366.           Year           This should be a four digit number plus, where
  3367.                          appropriate, a single lower case letter to
  3368.                          identify articles by the same author in the same
  3369.                          year. If you only have one for that year use only
  3370.                          a number.
  3371.  
  3372.           Edition        Type the edition as, for example "2nd" or "3rd".
  3373.                          During printing " Ed." will be added
  3374.                          automatically.
  3375.  
  3376.           Chapter        Type the full chapter title in this field, or
  3377.                          leave it blank if you are referencing a whole
  3378.                          book. You should use capital letters in the title
  3379.                          according to the convention you wish to adopt. The
  3380.                          program can cope with a much longer chapter title
  3381.                          than the size of the blank space on the screen. If
  3382.                          you fill the space just keep typing and you will
  3383.                          see the title scroll within the space. Use the
  3384.                          arrow keys or <Home> and <End> to move within the
  3385.                          scrolling window. Use <Enter> to move on to the
  3386.                          next field.
  3387.  
  3388.           Book Title     Type the full title of the book into this field.
  3389.                          Again, correct capitalization of the title is your
  3390.                          responsibility. This window can also scroll.
  3391.  
  3392.           Published By   This field should contain the name of the
  3393.                          publishing house. It also scrolls.
  3394.  
  3395.           at             This field should contain the name of the city
  3396.                          where the book was published.
  3397.  
  3398.           Pages          Put the first page number of the item in the first
  3399.                          page field and the last in the second field. You
  3400.                          may use page numbers which are non-numeric if
  3401.                          appropriate. If the item is on a single page,
  3402.                          leave the second field blank. If no page numbers
  3403.                          are appropriate leave both fields blank. Do not
  3404.                          put "p" or "pp" in the page fields.
  3405.  
  3406.           Notes          This field may be used to note a library call
  3407.                          number or other information about the item. It is
  3408.                          a fixed length field and it is normally only
  3409.  
  3410.  
  3411.  
  3412.  
  3413.           BIBLOGIC                                                  Page 53
  3414.  
  3415.                                                                   Reference
  3416.  
  3417.  
  3418.                          displayed on the screen when editing the
  3419.                          reference. It is not normally printed (however,
  3420.                          see page 78.)
  3421.  
  3422.           Cited in       This field is used to indicate the source of the
  3423.                          reference. It is not normally used in the
  3424.                          preparation of references (but see below), it is
  3425.                          only for you own information. This field contains
  3426.                          B or J to indicate "book" or "journal article".
  3427.  
  3428.           Number         This field can contain the number of the reference
  3429.                          where this item was cited.
  3430.  
  3431.           Use citation   Normally this field will contain "N" and the
  3432.                          information in the previous two fields will not
  3433.                          appear in finished reference lists. If this field
  3434.                          contains "Y" the citing reference will be looked
  3435.                          up and "Cited in:" and the authors and year of the
  3436.                          citing reference will be appended to the cited
  3437.                          reference. You should make sure that the citing
  3438.                          reference also appears in your reference list.
  3439.  
  3440.                          If you like, you can use T for "True" and F for
  3441.                          "False" instead of Y and N.
  3442.  
  3443.                If there is no information to put in a particular field,
  3444.           leave it entirely blank. This will ensure that the format of
  3445.           printed references will be as close as possible to the desired
  3446.           output.
  3447.  
  3448.                In the event that there is information which you will have
  3449.           to fill in or change later, type a "+" in the field, along with a
  3450.           note. This will help you locate the reference in a list with your
  3451.           word processor. "+" is also used to "flag" error messages in the
  3452.           listing process (when for example an unlisted journal is
  3453.           referenced) so it is a good idea to use this for "manually"
  3454.           inserted flags as well. It can sometimes be useful to put
  3455.           something in the Notes field to remind you what is missing.
  3456.  
  3457.                In the special case where a book is being quoted as a whole,
  3458.           there may be no authors, only editors, to quote. The program can
  3459.           recognize this if you use the following technique. Put the
  3460.           editors names in the authors field, put the first editors surname
  3461.           also in the first editor name field, and make sure you do not
  3462.           input anything into the Chapters field. Under these special
  3463.           circumstances the reference will be output as (for example) :
  3464.  
  3465.           Smith A. B. and Jones C. D. (Eds) (1987).........
  3466.  
  3467.  
  3468.  
  3469.  
  3470.  
  3471.  
  3472.           BIBLOGIC                                                  Page 54
  3473.  
  3474.                                                                   Reference
  3475.  
  3476.  
  3477.           5.2.2. Special features
  3478.  
  3479.           5.2.2.1. Moving the cursor between names
  3480.  
  3481.                You may move between the name fields by pressing <Enter> as
  3482.           described above, or you may use the arrow keys.
  3483.  
  3484.                The arrow keys work in a special way when the names are
  3485.           being input. This is designed to minimize the number of
  3486.           keystrokes when inputting or changing authors and editors without
  3487.           you having to remember special function keys. Although the action
  3488.           of these keys may seem complicated at first, take a few moments
  3489.           to try the various options and you will see the logic behind
  3490.           them.
  3491.  
  3492.                The <Enter> key simply moves you on to the next field, with
  3493.           one exception. When you press <Enter> in an empty Author surname
  3494.           field (usually the one after the last name that has been input)
  3495.           the cursor moves on over all of the remaining names to the
  3496.           editors. When inputting editors, pressing the <Enter> key in an
  3497.           empty surname field moves you on to the year field (i.e. on to
  3498.           the rest of the reference).
  3499.  
  3500.                The up-arrow and down-arrow keys can move the cursor from
  3501.           initial to initial, but if they are pressed when the cursor is on
  3502.           a surname they move you from name to name. To get from a surname
  3503.           to the corresponding initials you must press the <Enter> key
  3504.           (because the down-arrow key will skip the initials).
  3505.  
  3506.                The left- and right-arrow keys only move you within a name,
  3507.           and cannot move you from field to field.
  3508.  
  3509.                When you have gone on to the rest of the reference, you can
  3510.           go back up to make alterations to the authors or editors using
  3511.           the up-arrow key. When you reach the year field, a single press
  3512.           of this key takes you to the first author, rather than to one of
  3513.           the unused fields.
  3514.  
  3515.           5.2.2.2. Copying a previous reference
  3516.  
  3517.                Frequently, several similar references (for example
  3518.           references for chapters in the same book) are input one after
  3519.           another. BIBLOGIC allows you to copy information from any field
  3520.           in a previous reference to a new reference that is being added.
  3521.           To do this, press <F2>. You will see a list of the most recently
  3522.           added references (in the order that they were added). Move the
  3523.           cursor to the reference you want to copy using the up- and
  3524.           down-arrow keys (or <Pg Up> and <Pg Dn> keys). Press <Enter> to
  3525.           return to the new reference. The field you are in will be filled
  3526.  
  3527.  
  3528.  
  3529.  
  3530.  
  3531.           BIBLOGIC                                                  Page 55
  3532.  
  3533.                                                                   Reference
  3534.  
  3535.  
  3536.           in from the old reference that you selected. When you
  3537.           subsequently press <F2> in any other field, that field will also
  3538.           be filled in from the old reference that you selected.
  3539.  
  3540.           5.2.2.3. Checking for duplicates
  3541.  
  3542.                When a reference is being input (or edited), pressing the
  3543.           "help" key <F1> will display a list of existing books or chapters
  3544.           in Author/year order. This can help you to avoid duplicating a
  3545.           reference in the system. The current reference will be
  3546.           highlighted. The up- and down-arrow keys (and <Pg Up> <Pg Dn>)
  3547.           can be used to browse through the list. When <Esc> is pressed to
  3548.           return to data input, the reference that was originally being
  3549.           input will be returned to the screen.
  3550.  
  3551.  
  3552.  
  3553.  
  3554.  
  3555.  
  3556.  
  3557.  
  3558.  
  3559.  
  3560.  
  3561.  
  3562.  
  3563.  
  3564.  
  3565.  
  3566.  
  3567.  
  3568.  
  3569.  
  3570.  
  3571.  
  3572.  
  3573.  
  3574.  
  3575.  
  3576.  
  3577.  
  3578.  
  3579.  
  3580.  
  3581.  
  3582.  
  3583.  
  3584.  
  3585.  
  3586.  
  3587.  
  3588.  
  3589.  
  3590.           BIBLOGIC                                                  Page 56
  3591.  
  3592.                                                                   Reference
  3593.  
  3594.  
  3595.           5.2.3. Inputting a review
  3596.  
  3597.                When you have finished putting in the bibliographic details
  3598.           on this item you can go on by using the <Pg Dn> key. Pressing
  3599.           <Esc> will abandon this reference and return you to the menu.
  3600.  
  3601.                Normally, the program will now require you to enter at least
  3602.           one review for the new reference you have input so you will then
  3603.           see a review page.
  3604.  
  3605.                This screen contains part of the bibliographic information
  3606.           on the item above the top line and blank fields to fill beneath
  3607.           the line. Fill out these fields as follows:
  3608.  
  3609.           Comments       Enter this field by pressing <F3>. Type your
  3610.                          comments on the article. Use two <Enter>s to
  3611.                          separate paragraphs, but do not press <Enter> at
  3612.                          the end of each line - let the program format the
  3613.                          lines. Press <F4> to exit from this field.
  3614.           Topic          Use the numbering system you have developed.
  3615.           Page           The page in the book to which the review refers
  3616.                          (if applicable).
  3617.  
  3618.           Full details of the functions available while editing comments
  3619.           are given in an Appendix (see page 93). The amount of text you
  3620.           can put into the comments field is limited to about 1000 - 1500
  3621.           lines (depending on their length - see page 93). In practice, it
  3622.           usually is better to enter several reviews with one or two
  3623.           paragraph comments on an article, rather than one with a very
  3624.           large comment. By individually categorizing the comments by
  3625.           topic, you will have access to your references and comments in a
  3626.           more useful fashion.
  3627.  
  3628.                Note that <F2> may be used to copy a field from a previously
  3629.           entered review in a similar way to in references except that, in
  3630.           a review, <F2> always copies from the most recently added review.
  3631.  
  3632.                When you have finished putting in a review, you can leave
  3633.           the review either by pressing <Enter> at the last field or by
  3634.           pressing <Pg Dn>. In either case the review will be saved and
  3635.           another blank review will appear. You can put in as many reviews
  3636.           on the reference as you like. When you have put in all of the
  3637.           reviews that you require for that particular book, press <Esc>
  3638.           when the next new blank is displayed.
  3639.  
  3640.                You will now see another blank reference. Continue filling
  3641.           in references or press <Esc> to return to the menu.
  3642.  
  3643.                Note that, although the program will present you with a
  3644.           blank review after each reference has been put in, it is possible
  3645.           to press <Esc> and avoid putting in any reviews at all for that
  3646.  
  3647.  
  3648.  
  3649.           BIBLOGIC                                                  Page 57
  3650.  
  3651.                                                                   Reference
  3652.  
  3653.  
  3654.           reference. It is however, recommended that each reference has at
  3655.           least one review (even if no comments are put in) otherwise
  3656.           retrieval of that reference by topic will not be possible.
  3657.  
  3658.           5.2.4. Edit - Change a book reference
  3659.  
  3660.           5.2.4.1. Editing by reference number
  3661.  
  3662.                Select this option to change the details stored about a
  3663.           particular chapter or book. You will be asked to give the
  3664.           reference number of the item you wish to change. This is the
  3665.           quickest way to find the required item, so you should input this
  3666.           number if it is known (but see the notes on authors below).
  3667.  
  3668.                The program will then find the right reference and you can
  3669.           proceed in just the same way as if you were inputting a new
  3670.           reference. When you have finished making alterations you can use
  3671.           <Ctrl W> or <Pg Dn> to save the changes. Pressing <Esc> will also
  3672.           save the changes, except any changes to the field currently being
  3673.           edited. This allows you to escape from changes accidentally made
  3674.           to a field.
  3675.  
  3676.                If you wish to completely delete a reference, you can do so
  3677.           by pressing <Alt F10> while editing it. The program will then ask
  3678.           you to confirm that you want to delete the reference by pressing
  3679.           <Alt F10> a second time. The number of the reference that is
  3680.           deleted cannot be reused, and the numbers of other references
  3681.           will not be affected. You should not delete references except
  3682.           under exceptional circumstances. Normally references that are not
  3683.           useful to you can remain in the system (but will have topic codes
  3684.           which will not cause them to be listed). A reference can also be
  3685.           edited to change it into a completely different reference. If
  3686.           deleting a reference, be sure to delete the reviews for the
  3687.           reference as well.
  3688.  
  3689.           5.2.4.2. Editing with searches
  3690.  
  3691.                If you do not know the reference number of the item, answer
  3692.           "0" (i.e. just press <Enter>) instead of giving a number. You can
  3693.           then search for a particular author, search the book and chapter
  3694.           titles for particular words, and restrict the search to
  3695.           particular years. Type in the word you are looking for (or part
  3696.           of it) into the appropriate field on the screen. Step over unused
  3697.           fields using the <Enter> key. After the last field is filled (or
  3698.           if you press <Pg Dn>) the program will search for the required
  3699.           reference. Upper and lower case will not be differentiated in the
  3700.           search, but if you input a string containing spaces in the middle
  3701.           (e.g. "OF THE HEART"), the spacing must be exact for the search
  3702.           to work. You can use part words in the search, for example "vis"
  3703.           will find "vision", "visual", "visually", "visit" and so on.
  3704.  
  3705.  
  3706.  
  3707.  
  3708.           BIBLOGIC                                                  Page 58
  3709.  
  3710.                                                                   Reference
  3711.  
  3712.  
  3713.                The earliest year and latest year fields are used to specify
  3714.           a search restricted to material of a certain age. For example to
  3715.           look at references published only in 1979, put 1979 in both
  3716.           fields. For a search from 1979 to the present put 1979 in the
  3717.           earliest year field and leave the latest year field blank. For
  3718.           references before 1979 leave the earliest year field blank but
  3719.           put 1978 in the latest year field.
  3720.  
  3721.                For any of these searches, once a matching reference has
  3722.           been found, you can use <Pg Dn> to get to other references which
  3723.           match the criteria you have given. <Pg Up> may be used to go back
  3724.           to the previous matching reference, and you may use <Esc> or
  3725.           <Ctrl W> to get back to the menu without going through any more
  3726.           matching references. Note though, that <Esc> does not save any
  3727.           changes made to the field you are currently on.
  3728.  
  3729.                The program keeps an index of first authors' names - so if
  3730.           you know the first author or even just the first few letters of
  3731.           the first author's name, type this in. This will greatly increase
  3732.           the speed of this type of search. If you cannot supply this
  3733.           information the program can still look for the reference, but it
  3734.           will have to look through the entire database so the search will
  3735.           be slower (possibly several minutes in a database with thousands
  3736.           of entries on an "XT" type computer).
  3737.  
  3738.           5.2.4.3. Special author searches
  3739.  
  3740.                The program can also search for an name in author fields
  3741.           other than the first and it can search for names when you are not
  3742.           sure of the spelling (although both of these searches are much
  3743.           slower than a search of first author only). To use these special
  3744.           features a * or ? are typed in after the name. For example:
  3745.  
  3746.           First author: Smith   finds Smith & Jones but not Jones & Smith
  3747.           First author: Smith*  finds Smith & Jones or Jones & Smith
  3748.           First author: Smith?  finds Smythe & Jones but not Jones & Smythe
  3749.           First author: Smith*? finds Smythe & Jones or Jones & Smythe
  3750.  
  3751.           * causes the program to search all of the author fields.
  3752.           ? causes the program to look for "similar" names
  3753.  
  3754.                The program can only use the author index for the first of
  3755.           these searches, so the others are slower. In all cases if words
  3756.           in titles or years are also specified then only references
  3757.           satisfying these criteria as well as the name criterion will be
  3758.           shown by the program.
  3759.  
  3760.                The search invoked by the ? symbol is based on a special
  3761.           technique which is described in the appendix on page 97. It is
  3762.           not guaranteed to find what you want, but it will generally pull
  3763.  
  3764.  
  3765.  
  3766.  
  3767.           BIBLOGIC                                                  Page 59
  3768.  
  3769.                                                                   Reference
  3770.  
  3771.  
  3772.           out similar sounding names, such as Anderson, Andreassen and so
  3773.           on. The program will not find the name unless you have the first
  3774.           letter of the name correct.
  3775.  
  3776.                When you are editing references you may use the "help" key
  3777.           <F1> to show a list of authors in the same way as when inputting
  3778.           new references. The list will, however, include all references
  3779.           (not just those that satisfy the author, year and word criteria).
  3780.  
  3781.           5.2.5. Examine - Look at existing book references
  3782.  
  3783.                This option is exactly the same as the "Edit existing
  3784.           references" option, except you can only look at, not alter, the
  3785.           contents of the references. It is best to use this option to
  3786.           browse through references if you do not intend to alter them. It
  3787.           is quite easy to go back and use the edit option on a particular
  3788.           reference (make a note of its reference number) if you find you
  3789.           need to alter it.
  3790.  
  3791.                If you have used the word searching facility to find
  3792.           references, the page you see will be the first reference in the
  3793.           database which matches the criteria. You may use <Pg Up>, <Pg Dn>
  3794.           and so on as you would when editing references to move between
  3795.           different references which meet the criteria.
  3796.  
  3797.  
  3798.  
  3799.  
  3800.  
  3801.  
  3802.  
  3803.  
  3804.  
  3805.  
  3806.  
  3807.  
  3808.  
  3809.  
  3810.  
  3811.  
  3812.  
  3813.  
  3814.  
  3815.  
  3816.  
  3817.  
  3818.  
  3819.  
  3820.  
  3821.  
  3822.  
  3823.  
  3824.  
  3825.  
  3826.           BIBLOGIC                                                  Page 60
  3827.  
  3828.                                                                   Reference
  3829.  
  3830.  
  3831.           5.3. THE ARTICLES MENU
  3832.  
  3833.           The options on the ARTICLES menu are:
  3834.  
  3835.                               1. Add
  3836.                               2. Edit
  3837.                               3. Examine
  3838.  
  3839.                These options function similarly to the options on the BOOKS
  3840.           menu, but on the Journal Article references database.
  3841.  
  3842.           5.3.1. Add - Add new journal article references
  3843.  
  3844.                Select this option to input bibliographic details on a
  3845.           journal article. When you select this option you will be provided
  3846.           with a new, blank, record to fill in.
  3847.  
  3848.                Type the first author's surname followed by <Enter> and then
  3849.           each initial followed by <Enter>. Continue in this manner for all
  3850.           the authors. As with books references, the first letter of the
  3851.           surname and initials are automatically capitalized. Again, you
  3852.           should ALWAYS type names with the <Caps Lock> OFF. For the very
  3853.           few names which do not begin with a capital (e.g."deBurgh") start
  3854.           the name with a <Space> to avoid automatic capitalization of the
  3855.           first letter.
  3856.  
  3857.                The program will automatically number the reference in a
  3858.           similar way as with book references, starting with J1 for the
  3859.           first reference in the database. This number should be noted on
  3860.           your copy of the reference.
  3861.  
  3862.                Fill out the rest of the information, noting the following
  3863.           points:
  3864.  
  3865.           Title          Type the title of the article in this field. The
  3866.                          program can cope with a much longer title than the
  3867.                          size of the blank space on the screen. If you fill
  3868.                          the space just keep typing and you will see the
  3869.                          title scroll within the space. Use the arrow keys
  3870.                          or <Home> and <End> to move within the scrolling
  3871.                          window. Use <Enter> to move on to the next field.
  3872.  
  3873.           Journal        Type the number corresponding to the appropriate
  3874.                          journal in your journal list. When the cursor is
  3875.                          over this field, pressing the "help" key, <F1>
  3876.                          will show the currently selected journal list. You
  3877.                          may scroll through the list using the arrow keys,
  3878.                          or the letter keys (for example pressing J will
  3879.                          take you to the journals that start with J). Press
  3880.                          <Esc> to go back to editing the reference without
  3881.                          altering the journal recorded for that reference
  3882.  
  3883.  
  3884.  
  3885.           BIBLOGIC                                                  Page 61
  3886.  
  3887.                                                                   Reference
  3888.  
  3889.  
  3890.                          or press <Enter> to select that journal title. The
  3891.                          title corresponding to the number put into the
  3892.                          Journal field will be displayed below the field.
  3893.  
  3894.           Year           This should be a four digit number plus, where
  3895.                          appropriate, a single lower case letter to
  3896.                          identify articles by the same author in the same
  3897.                          year. If you only have one for that year, use only
  3898.                          a number.
  3899.  
  3900.           Volume         This field should contain the volume number of the
  3901.                          journal containing the article, if applicable.
  3902.                          This will normally be just a volume number, or
  3903.                          volume and issue in the form 10(2). The volume may
  3904.                          be non-numeric (for example "IV").
  3905.  
  3906.           Supplement     This field should contain the supplement number
  3907.                          (or letter), if applicable. In the special case
  3908.                          where just 0 is entered in this field, the program
  3909.                          will output 'Suppl.' with no number.
  3910.  
  3911.           Pages          Put the first page number of the article in the
  3912.                          first page field and the last in the second field
  3913.                          You may use page numbers which are non-numeric if
  3914.                          appropriate. If the item is on a single page,
  3915.                          leave the second field blank. If no page numbers
  3916.                          are appropriate leave both fields blank. Do not
  3917.                          put "p" or "pp" into the page fields.
  3918.  
  3919.           Notes          This field may be used to note a library call
  3920.                          number or other information about the item. It is
  3921.                          a fixed length field and it is normally only
  3922.                          displayed on the screen when editing the reference
  3923.                          itself (but see page 78).
  3924.  
  3925.           Cited in       This field is used to indicate the source of the
  3926.                          reference. It is not normally used in the
  3927.                          preparation of references (but see below). This
  3928.                          field contains B or J to indicate "book" or
  3929.                          "journal article".
  3930.  
  3931.           Number         This field should contain the number of the
  3932.                          reference where this item was cited.
  3933.  
  3934.           Use citation   Normally this field will contain "N" and the
  3935.                          information in the previous two fields will not
  3936.                          appear in finished reference printouts. If this
  3937.                          field contains "Y" the citing reference will be
  3938.                          looked up and "Cited in:" and the authors and year
  3939.  
  3940.  
  3941.  
  3942.  
  3943.  
  3944.           BIBLOGIC                                                  Page 62
  3945.  
  3946.                                                                   Reference
  3947.  
  3948.  
  3949.                          of the citing reference will be appended to the
  3950.                          cited reference. You should make sure that the
  3951.                          citing reference appears in your reference list.
  3952.  
  3953.                          If you like, you can use T for "True" and F for
  3954.                          "False" instead of Y and N.
  3955.  
  3956.           5.3.1.1. Special features
  3957.  
  3958.                Similar special features as those available when inputting
  3959.           book references are available when inputting a journal article
  3960.           reference. Press <F2> to copy from a recently added reference in
  3961.           exactly the same way as with a book reference. The <F1> key will
  3962.           show you an alphabetical list of authors (just like in a book
  3963.           reference) on any field except the journal title field (when the
  3964.           journal list is displayed as described above).
  3965.  
  3966.                When you have finished inputting details on this item you
  3967.           can go on to do another by using the arrow keys or <Pg Dn>.
  3968.  
  3969.                You will then be provided with a blank review to fill in.
  3970.           Enter as many reviews as required and then press <Esc> when
  3971.           presented with an unwanted new blank. You will then be given a
  3972.           new blank reference. Enter the next reference or press <Esc>. to
  3973.           go back to the menu.
  3974.  
  3975.                This function is otherwise identical to adding a book
  3976.           reference.
  3977.  
  3978.           5.3.2. Edit - Change existing references
  3979.  
  3980.                This option functions almost exactly the same way as the
  3981.           equivalent option on the BOOKS menu. If you do not know the
  3982.           number of the item you wish to locate, type "0" for the article
  3983.           number and fill in the search screen.
  3984.  
  3985.                Searches for an author using * and ? symbols work in the
  3986.           same way as for book references (see page 59).
  3987.  
  3988.                References may be deleted by pressing <Alt F10>, but this
  3989.           should only be done under exceptional circumstances.
  3990.  
  3991.           5.3.3. Examine - Look at existing references
  3992.  
  3993.                This option is exactly the same as the "Edit existing
  3994.           references" option except you can only look at, not alter, the
  3995.           contents of the references.
  3996.  
  3997.  
  3998.  
  3999.  
  4000.  
  4001.  
  4002.  
  4003.           BIBLOGIC                                                  Page 63
  4004.  
  4005.                                                                   Reference
  4006.  
  4007.  
  4008.           5.4. THE REVIEWS MENU
  4009.  
  4010.           The options on the REVIEWS menu are:
  4011.  
  4012.                               1. Add
  4013.                               2. Edit
  4014.  
  4015.           5.4.1. Add - Add new reviews
  4016.  
  4017.                This option is used to input reviews at a time other than
  4018.           when you enter the corresponding reference.
  4019.  
  4020.                When you select this option you will be asked to provide the
  4021.           reference number for the book or journal article you are
  4022.           categorizing. Reviews on both books and journal articles are
  4023.           stored together so you must provide a number beginning with B or
  4024.           J to differentiate between them.
  4025.  
  4026.                Reviews are then entered in the same way as described in the
  4027.           BOOKS menu section on page 57.
  4028.  
  4029.           5.4.1.1. Special Features
  4030.  
  4031.                When the cursor is in the topic field of a review, you can
  4032.           get help on topic codes by pressing <F1>. This help is in the
  4033.           form of your own notes (or reminder screens) on your topic
  4034.           structure. See the appendix on page 99 for details.
  4035.  
  4036.           5.4.2. Edit - Change existing reviews
  4037.  
  4038.                You can edit an existing review by selecting this option.
  4039.           You will be asked for a book or journal number. Type in B or J
  4040.           followed by the appropriate number to search for reviews on this
  4041.           item. You will then be asked for a page number. Normally you will
  4042.           leave this blank but if you have many reviews on a particular
  4043.           item you may wish to include a page number so you start in the
  4044.           appropriate review. When the review is found you will be able to
  4045.           move between all reviews on this item using the <Pg Up> and
  4046.           <Pg Dn> keys.
  4047.  
  4048.                If you want to edit reviews based on the topic, rather than
  4049.           reference number, leave the reference number blank and press
  4050.           <Enter>. You will be asked for a topic to search on instead. You
  4051.           can put asterisks (*) in the topic to match with any digit in
  4052.           that position. This is not the best way to find reviews as it
  4053.           takes much longer for the program to find them (than by reference
  4054.           number) in a very large database.
  4055.  
  4056.  
  4057.  
  4058.  
  4059.  
  4060.  
  4061.  
  4062.           BIBLOGIC                                                  Page 64
  4063.  
  4064.                                                                   Reference
  4065.  
  4066.  
  4067.                Alternately, you may search for the occurrence of a
  4068.           particular word in the comments fields. If you put anything in
  4069.           the "search comments for" field the topic code will be ignored
  4070.           and you will see only reviews that contain the given word in the
  4071.           comments.
  4072.  
  4073.                Note that, because <Pg Dn> takes you to the next review that
  4074.           meets the topic criteria (and this may take some time to find)
  4075.           you should use <Ctrl W> rather than <Pg Dn> to get back to the
  4076.           menu when you have seen all the reviews you wish to. <Esc> may be
  4077.           used in the same way, but should not be used if you have made
  4078.           changes to the current review as it will not save the field you
  4079.           are currently on (this allows you to abort from an accidental
  4080.           alteration to a field).
  4081.  
  4082.                A review can be deleted entirely from the database by
  4083.           pressing <Alt F10>. The program will then ask you to confirm this
  4084.           by pressing <Alt F10> again.
  4085.  
  4086.  
  4087.  
  4088.  
  4089.  
  4090.  
  4091.  
  4092.  
  4093.  
  4094.  
  4095.  
  4096.  
  4097.  
  4098.  
  4099.  
  4100.  
  4101.  
  4102.  
  4103.  
  4104.  
  4105.  
  4106.  
  4107.  
  4108.  
  4109.  
  4110.  
  4111.  
  4112.  
  4113.  
  4114.  
  4115.  
  4116.  
  4117.  
  4118.  
  4119.  
  4120.  
  4121.           BIBLOGIC                                                  Page 65
  4122.  
  4123.                                                                   Reference
  4124.  
  4125.  
  4126.           5.5. THE LISTS MENU
  4127.  
  4128.           The options on the LISTS menu are:
  4129.  
  4130.  
  4131.                               1. References
  4132.                               2. Comments with number
  4133.                               3. Comments with authors
  4134.                               4. Comments with reference
  4135.                               5. Journals
  4136.                               6. Manual list
  4137.  
  4138.  
  4139.           5.5.1. References - List full references
  4140.  
  4141.                This option allows you to generate a file containing
  4142.           properly formatted references which you can include in a document
  4143.           using your word processor. The format used for the reference is
  4144.           determined by the currently selected print format file. See page
  4145.           71 for details of how to switch between different format files,
  4146.           and how to create new ones.
  4147.  
  4148.                The file produced by BIBLOGIC can be read into your word
  4149.           processor to be included in a document or printed out. The
  4150.           procedure to read the file in varies from one word processor to
  4151.           another. Consult the supplement on word processors at the back of
  4152.           the manual for details of how to do this for your word processor.
  4153.  
  4154.                The references are usually selected on the basis of the
  4155.           category information in the reviews. Only references which have a
  4156.           review in the system can be selected.
  4157.  
  4158.                The references will normally be listed in alphabetical
  4159.           order, but they may optionally be listed in year order.
  4160.  
  4161.                When you select this option, the program will ask for a
  4162.           "topic" (or a word to search comments for), a number to start
  4163.           numbering from and a name for the output file. Type in the
  4164.           required topic code. Use asterisks (*) to define "don't care"
  4165.           levels in the topic. For example choosing "123*******" will list
  4166.           all references with topics starting "123" with no regard for the
  4167.           right-most seven digits. If you want to list references which
  4168.           have a particular word in the review comments put this word in
  4169.           the "search comments for" field. If you do this the topic codes
  4170.           will be ignored.
  4171.  
  4172.                If you want the references that are output to be numbered in
  4173.           sequence, put the number of the first reference in the "number
  4174.           from" field. This will usually be 1 unless the list is to be a
  4175.           continuation from another list. If you do not want the references
  4176.           to be numbered, put "0" in this field.
  4177.  
  4178.  
  4179.  
  4180.           BIBLOGIC                                                  Page 66
  4181.  
  4182.                                                                   Reference
  4183.  
  4184.  
  4185.  
  4186.                Choose a name for the output file, it can be up to eight
  4187.           characters. An extension ".TXT" will be added automatically.
  4188.  
  4189.                Normally, a list will consist of both book and journal
  4190.           article references, but you can restrict the list to references
  4191.           of one type or the other by putting B or J in the "Books, Journal
  4192.           articles or All ?" field.
  4193.  
  4194.                Sometimes it is useful to generate a list which includes the
  4195.           actual B or J numbers against each reference. If you want this,
  4196.           answer "Y" to "Show B/J numbers ?".
  4197.  
  4198.                A list in year order is produced by putting "Y" in the "Sort
  4199.           by year ?" field.
  4200.  
  4201.                After filling in the last field, press <Enter> (or <Pg Dn>
  4202.           if you want to skip fields). The program will start to compile
  4203.           the list. This can take several minutes with a very large
  4204.           database, so the program will keep you informed of its progress
  4205.           with messages on the screen:
  4206.  
  4207.           Loading print format....
  4208.           Opening output file....
  4209.           **** Press <Esc> at any stage if you wish to abort listing ****
  4210.           Setting up work area on disk....
  4211.           Finding required reviews....
  4212.           Removing duplicates....
  4213.           Looking up book references....
  4214.           Looking up journal article references....
  4215.           Sorting book references....
  4216.           Sorting journal article references....
  4217.           Making list....
  4218.  
  4219.                It is not important to follow this process, but you may find
  4220.           it of interest to do so. First the program finds the currently
  4221.           selected print format file and loads it into memory. A file to
  4222.           hold the list to be produced is then created and some temporary
  4223.           files for intermediate lists are also created. The reviews that
  4224.           satisfy the criteria you have requested are then copied to a
  4225.           separate file. Because the reviews are in numerical order it is
  4226.           easy for the program to locate and delete duplications in the
  4227.           list.
  4228.  
  4229.                The book references and journal article references in the
  4230.           list are then separately looked up and two lists are compiled.
  4231.           These are then put into alphabetical order and the output file is
  4232.           generated from these lists. During the listing the print format
  4233.           file is used to control the format of the list and appropriate
  4234.           codes are inserted into the list for your word processor
  4235.           according to the information in the print format file.
  4236.  
  4237.  
  4238.  
  4239.           BIBLOGIC                                                  Page 67
  4240.  
  4241.                                                                   Reference
  4242.  
  4243.  
  4244.  
  4245.                If any articles on the topic selected were found, you will
  4246.           see a list of references scroll up the screen. You may notice
  4247.           unusual symbols in the references. These are the special codes
  4248.           which tell the word processor where special effects (such as bold
  4249.           and underline) are to be placed in the text. The list will
  4250.           normally scroll off the screen once the screen is full, but if
  4251.           you want to stop the list from scrolling (and pause the process
  4252.           of making the list) you can use <Ctrl S> to pause and <Ctrl Q> to
  4253.           re-start. Of course, you will also be able to look at the list
  4254.           using your word processor later.
  4255.  
  4256.                At the end of the process BIBLOGIC gives you two figures:
  4257.           1) how much disk space it used for temporary files during the
  4258.           listing and 2) how much disk space there is left after these
  4259.           temporary files have been removed. When the first figure
  4260.           approaches the second in size it means that the amount of space
  4261.           left on the disk will soon be too small for BIBLOGIC to generate
  4262.           the necessary temporary files to generate a reference listing.
  4263.           Then is a good time to clean up your disk by removing unwanted
  4264.           backup copies of documents, old data which is already backed up
  4265.           and so on.
  4266.  
  4267.           5.5.2. Comments with number
  4268.  
  4269.                This option allows you to put all the comments in a group of
  4270.           references into a file for word processing. The references are
  4271.           selected by topic, in the same way as when you list the
  4272.           references themselves. When you select this option, you will have
  4273.           to specify a topic and file name in a similar way to the
  4274.           reference list option. In this option the comments are identified
  4275.           in the list only by the reference number.
  4276.  
  4277.           5.5.3. Comments with authors
  4278.  
  4279.                This option is similar to the previous one, except the first
  4280.           and second authors' surnames and the year are also included in
  4281.           the list. The names are listed only for the first comment
  4282.           pertaining to a particular reference.
  4283.  
  4284.                If the reference has more than two authors, "et al." is
  4285.           appended to the surnames of the first two authors.
  4286.  
  4287.           5.5.4. Comments with reference
  4288.  
  4289.                This option lists the comments as above, but all of the
  4290.           bibliographic information on the items is included in the list.
  4291.           This can be used for making annotated reference lists for use as
  4292.           (for example) a reading list for students or a list of "new
  4293.           acquisitions" (assuming that these have been marked in some way
  4294.           using a topic code).
  4295.  
  4296.  
  4297.  
  4298.           BIBLOGIC                                                  Page 68
  4299.  
  4300.                                                                   Reference
  4301.  
  4302.  
  4303.  
  4304.                The options are similar to those for a reference list. You
  4305.           can choose to suppress the topic code printout, and you can
  4306.           choose to suppress the B/J numbers if these are not required.
  4307.  
  4308.                These options will be adequate for most purposes, but the
  4309.           "Extended comments" option is included to allow you to produce a
  4310.           special type of comments list.
  4311.  
  4312.                If this option is used, once the relevant references have
  4313.           been selected using a topic code in the usual way, the comments
  4314.           for the selected references that match this second code will be
  4315.           included in the list. This feature can be used in a number of
  4316.           ways, for example:
  4317.  
  4318.           1)   You may wish to categorize references with very specific
  4319.                topic codes for reference retrieval, but only wish to use
  4320.                the comments facility for general comments or abstracts. You
  4321.                can mark these abstracts with a particular code (for example
  4322.                an "A" in the first column) and then use this facility when
  4323.                making a comments list. Use the topic code in the usual way
  4324.                (to select references on a particular topic) and then
  4325.                request comments marked "A*********" to get a list of the
  4326.                abstracts for the references found.
  4327.  
  4328.           2)   You may wish to identify references which address both of
  4329.                two different concepts. Use the first topic code to select
  4330.                references on one topic and then list the comments attached
  4331.                to these references on a different topic.
  4332.  
  4333.           If you answer "Y" to "Extend comments ?", you will be asked:
  4334.  
  4335.           Topic code to list for selected references ? **********
  4336.  
  4337.           The second topic code is entered at this point.
  4338.  
  4339.           5.5.5. Journals - List journal titles
  4340.  
  4341.                This option allows you to make a list of the journal titles
  4342.           in the currently selected journal list. You will be asked if you
  4343.           want the list to be in alphabetical order. Answer "Y" for
  4344.           alphabetical or "N" for numerical order. Press the <Enter> key.
  4345.           If the program has been set up to use a printer (see page 72),
  4346.           the list will be directed to the printer, as well as to a file on
  4347.           disk and on the screen. If the printer is not ready, or the
  4348.           program is not set up to use a printer the list will only be sent
  4349.           to the screen and to disk.
  4350.  
  4351.  
  4352.  
  4353.  
  4354.  
  4355.  
  4356.  
  4357.           BIBLOGIC                                                  Page 69
  4358.  
  4359.                                                                   Reference
  4360.  
  4361.  
  4362.                The disk file will have the same name as the journal list
  4363.           itself, with the extension ".ALP" for a list in alphabetical
  4364.           order, or ".NMR" for a list in numerical order. It is an ASCII
  4365.           file.
  4366.  
  4367.           5.5.6. Manual list
  4368.  
  4369.                A list of properly formatted references in an arbitrary
  4370.           order, determined by the user, can be made using this option. To
  4371.           do this, a list of B and J numbers (in the required order) must
  4372.           first be made outside BIBLOGIC. This may be done in your word
  4373.           processor, but the list must be saved as a plain ASCII file with
  4374.           no formatting characters. If your word processor cannot do this,
  4375.           you could use the editor provided with DOS or the DOS copy
  4376.           command (for example: "copy con list.msr") to create a file (see
  4377.           your DOS manual for details).
  4378.  
  4379.                The file must have the extension ".MSR" (for example, it
  4380.           could be called "LIST.MSR"). Each B or J number must start on a
  4381.           new line and there should be no spaces in the numbers and no
  4382.           blank lines.
  4383.  
  4384.  
  4385.  
  4386.  
  4387.  
  4388.  
  4389.  
  4390.  
  4391.  
  4392.  
  4393.  
  4394.  
  4395.  
  4396.  
  4397.  
  4398.  
  4399.  
  4400.  
  4401.  
  4402.  
  4403.  
  4404.  
  4405.  
  4406.  
  4407.  
  4408.  
  4409.  
  4410.  
  4411.  
  4412.  
  4413.  
  4414.  
  4415.  
  4416.           BIBLOGIC                                                  Page 70
  4417.  
  4418.                                                                   Reference
  4419.  
  4420.  
  4421.           5.6. THE SET-UP MENU
  4422.  
  4423.           The options on this menu are:
  4424.  
  4425.                               1. Configure
  4426.                               2. New journal list
  4427.                               3. Edit journal list
  4428.                               4. New database
  4429.                               5. New print format
  4430.                               6. Edit print format
  4431.                               7. Set numbers
  4432.                               8. Medline/DIALOG conversions
  4433.                               9. Exit from BIBLOGIC
  4434.  
  4435.  
  4436.           5.6.1. Configuration
  4437.  
  4438.                This option allows you to set up the program for use in a
  4439.           different operating environment or for use by different
  4440.           operators.
  4441.  
  4442.                When you select this option you will be shown the existing
  4443.           configuration, and must fill in the following parameters:
  4444.  
  4445.           Database       This is the name of the database the program is to
  4446.                          use. Normally one person would have just one
  4447.                          database, but different users would often keep
  4448.                          their references in different databases. You
  4449.                          should avoid generating different databases based
  4450.                          just on subject unless there is little or no
  4451.                          overlap between the subjects. The name of the
  4452.                          database should consist of up to eight characters,
  4453.                          letters and numbers only. The name is used to
  4454.                          generate several filenames (.BKS, .JAR, .RVU etc.)
  4455.                          and no extension should be typed. The program is
  4456.                          initially set up to use a database called
  4457.                          "DATABASE".
  4458.  
  4459.           Journal List   In many cases each database will have a separate
  4460.                          journal list associated with it, but there may be
  4461.                          cases where a single list serves several users, or
  4462.                          one user wishes to switch between several lists
  4463.                          (usually to accommodate different abbreviation
  4464.                          schemes). To do this change the name of the list
  4465.                          here. The name of the journal list should consist
  4466.                          of up to eight characters, letters and numbers
  4467.                          only. An extension of .JLS is assumed, and should
  4468.                          not be typed in. The program is initially set up
  4469.                          to use "JOURNALS".
  4470.  
  4471.  
  4472.  
  4473.  
  4474.  
  4475.           BIBLOGIC                                                  Page 71
  4476.  
  4477.                                                                   Reference
  4478.  
  4479.  
  4480.           Print Format   The print format file determines how reviews are
  4481.                          printed and what control codes are output for the
  4482.                          particular word processor being used. The file
  4483.                          name should consist of up to eight characters. An
  4484.                          extension of .PFF is assumed, and should not be
  4485.                          typed. The initial setting is "PRINTFOR"
  4486.  
  4487.           Printer Port   If you do not have a printer connected you should
  4488.                          leave this field blank. If you have a printer
  4489.                          connected to the computer this field should be set
  4490.                          as follows:
  4491.  
  4492.                          Port                     Name for field
  4493.                          Parallel port 1          LPT1
  4494.                          Parallel port 2          LPT2
  4495.                          Serial port 1            COM1
  4496.                          Serial port 2            COM2
  4497.  
  4498.                          If you are using a serial port for your printer,
  4499.                          it must be set up correctly using the DOS "MODE"
  4500.                          command before running BIBLOGIC (for example in
  4501.                          your "AUTOEXEC.BAT" file).
  4502.  
  4503.                          The program is initially set up for no printer
  4504.                          (i.e. this field is blank).
  4505.  
  4506.           Force Review   Normally the program "forces" the user to add a
  4507.                          review for a reference straight after the
  4508.                          reference is entered (although it is possible to
  4509.                          avoid entering a review at all by pressing the
  4510.                          <Esc> key at the blank review screen). If you do
  4511.                          not want to automatically go from references to
  4512.                          new reviews, select "N" for this option.
  4513.  
  4514.           Normal Review  In version 2.0 and later the TOPIC and PAGE fields
  4515.           Format         in a review appear in that order, with the topic
  4516.                          before the page. If you wish to have these fields
  4517.                          in the opposite order (like earlier versions of
  4518.                          the program) select "N" for this option.
  4519.  
  4520.           Beep on Finds  When you are searching through references (using
  4521.                          the edit or examine options) the program will
  4522.                          normally make a beep sound whenever it finds a
  4523.                          matching reference. If you wish to suppress this
  4524.                          feature, select "N" for this option.
  4525.  
  4526.  
  4527.  
  4528.  
  4529.  
  4530.  
  4531.  
  4532.  
  4533.  
  4534.           BIBLOGIC                                                  Page 72
  4535.  
  4536.                                                                   Reference
  4537.  
  4538.  
  4539.           5.6.2. New journal list
  4540.  
  4541.                This option allows you to make a new journal list, either
  4542.           completely from "scratch" or by copying and altering an existing
  4543.           list. When you select this option you will be asked if you want
  4544.           to copy an existing list.
  4545.  
  4546.                If you answer "Y", you will be given a list of existing
  4547.           journal list (.JLS) files and asked for the name of the old file
  4548.           to copy, and the name of the new file. If you try to copy a file
  4549.           which does not exist, or give an existing name for the new file
  4550.           an error message will be given and you will be asked to specify
  4551.           the names again. You may quit from this screen by pressing <Esc>.
  4552.  
  4553.                If you answer "N" in response to the initial question, you
  4554.           will also be given a list of existing .JLS files and you will be
  4555.           asked for the name of the new list. If you specify an existing
  4556.           file name for the new list an error message will be given and you
  4557.           will be asked to re-enter the name. You may quit from this
  4558.           process by pressing <Esc>.
  4559.  
  4560.                In either case a new list will be produced, either
  4561.           containing the same journals as the original list, or completely
  4562.           blank, as requested.
  4563.  
  4564.           5.6.3. Edit journal list
  4565.  
  4566.                This option allows you to change the contents of an existing
  4567.           journal list. When you select this option you will be given a
  4568.           list of existing .JLS files and will be asked for the name of the
  4569.           file you wish to edit.
  4570.  
  4571.                You will then be asked if you want the list to be in
  4572.           alphabetical order. You may edit the list in alphabetical, or
  4573.           numerical order.
  4574.  
  4575.                The list will be put on the screen in two columns: journal
  4576.           numbers on the left and titles on the right. You may use the up-
  4577.           and down-arrows to move through the list a line at a time. The
  4578.           <Pg Up> and <Pg Dn> keys move to the journal at the top or bottom
  4579.           of the current screen. The <Home> and <End> keys move to the
  4580.           beginning or end of the whole list.
  4581.  
  4582.                In an alphabetical list, the letter keys may also be used to
  4583.           move to the relevant part of the list (for example, the "J" key
  4584.           will move the cursor to the first journal that begins with the
  4585.           letter "J").
  4586.  
  4587.  
  4588.  
  4589.  
  4590.  
  4591.  
  4592.  
  4593.           BIBLOGIC                                                  Page 73
  4594.  
  4595.                                                                   Reference
  4596.  
  4597.  
  4598.                The function keys shown above the list may be used to modify
  4599.           the list. You may DELETE the journal at the arrows using <F5>,
  4600.           ADD a new journal using <F6>, FIND a particular journal (<F7>) or
  4601.           EDIT it (change the number or title) using <F8>.
  4602.  
  4603.                Note that, when you add a journal or change an existing one,
  4604.           the order of the list is changed to keep the list in numerical or
  4605.           alphabetical order - although the arrows are kept at the
  4606.           appropriate journal.
  4607.  
  4608.                When you add a journal the program will find the highest
  4609.           numbered journal in the list and will fill in the number for the
  4610.           added journal one higher than this. You can change this number if
  4611.           you like, but the program will not let you use a number that has
  4612.           already been used (this is also true when you edit the number of
  4613.           an existing journal).
  4614.  
  4615.           5.6.4. New database
  4616.  
  4617.                This option allows you to make a new database, either
  4618.           completely from "scratch" or by copying and altering an existing
  4619.           database. When you select this option you will be asked if you
  4620.           want to copy an existing database.
  4621.  
  4622.                If you answer "Y" you will be given a list of existing
  4623.           databases (in fact a list of .BKS files - the database consists
  4624.           of others too) and you will be asked for the name of the old
  4625.           database to copy and the name of the new database. If you try to
  4626.           copy a database which does not exist, or give an existing name
  4627.           for the new database an error message will be given and you will
  4628.           be asked to specify the names again. You may quit from this
  4629.           screen by pressing <Esc>.
  4630.  
  4631.                If you answer "N" in response to the initial question, you
  4632.           will also be given a list of existing databases and you will be
  4633.           asked for the name of the new database. If you specify an
  4634.           existing database name for the new database, an error message
  4635.           will be given and you will be asked to re-enter the name. You may
  4636.           quit from this process by pressing <Esc>.
  4637.  
  4638.                In either case a new database will be produced, either
  4639.           containing the same data as the original database, or completely
  4640.           empty, as requested.
  4641.  
  4642.           5.6.5. New print format
  4643.  
  4644.                Print format files determine two things. Firstly they define
  4645.           the style or layout of the reference (for example, how the
  4646.           authors' names are laid out and where in the reference the year
  4647.           is to go). Secondly they define the special codes that are to be
  4648.           used by BIBLOGIC to tell the word processor you are using which
  4649.  
  4650.  
  4651.  
  4652.           BIBLOGIC                                                  Page 74
  4653.  
  4654.                                                                   Reference
  4655.  
  4656.  
  4657.           words are to be in bold, underlined and so on. A particular print
  4658.           format file is therefore specific to both your application (for
  4659.           example publishing in a particular journal) and to the word
  4660.           processor you are using.
  4661.  
  4662.                A number of example print format files for different word
  4663.           processors are supplied with BIBLOGIC, so the complicated part of
  4664.           print format design (describing to BIBLOGIC the special codes to
  4665.           use for bold, underline etc.) is already done for you.
  4666.  
  4667.                This option allows you to create a new print format file and
  4668.           determine the format it represents and the codes it uses.
  4669.  
  4670.                When you select this option you will be asked if you want to
  4671.           copy an existing file. If you answer "Y" you will be given a list
  4672.           of existing files and asked to input names for the old and new
  4673.           files. If you answer "N" you will be asked to name the new file.
  4674.  
  4675.                The program will than set up tables for editing the file you
  4676.           have produced. If you have copied an existing file the format
  4677.           will initially be the same as that which you copied, otherwise it
  4678.           will be the default format.
  4679.  
  4680.                Specifying the format is done in several distinct stages.
  4681.           This system has been designed to fall somewhere between "totally
  4682.           flexible and difficult to use" and "easy to use but inadequately
  4683.           flexible". As a result the process is a little involved but
  4684.           should allow you to cover most of the formats you are likely to
  4685.           need. Once you have generated the print formats that you require,
  4686.           you can simply call them up by name, so you do not have to go
  4687.           through the process of design very frequently.
  4688.  
  4689.                The first stage is to specify the format of the author's
  4690.           names.
  4691.  
  4692.           NAME FORMAT
  4693.  
  4694.                First you are given an example of the current name format
  4695.           and are asked if you want to change it. This allows you to bypass
  4696.           this step and go on to the YEAR FORMAT (see below) if the format
  4697.           is already as you want it. If you answer "Y" you must then answer
  4698.           specific questions about the name format:
  4699.  
  4700.           Where do you want the initials to be positioned ?
  4701.  
  4702.               1. After name:  Smith AB, McDonald DEF and Evans GH...
  4703.               2. Before name: AB Smith, DEF McDonald and GH Jones...
  4704.               3. Inverted:    Smith AB, DEF McDonald and GH Jones...
  4705.               4. Inverted:    AB Smith, McDonald DEF and Evans GH...
  4706.  
  4707.  
  4708.  
  4709.  
  4710.  
  4711.           BIBLOGIC                                                  Page 75
  4712.  
  4713.                                                                   Reference
  4714.  
  4715.  
  4716.           Normally you will choose option 1 or 2, but some journals do use
  4717.           options 3 or 4.
  4718.  
  4719.           Then:
  4720.  
  4721.           Do you want the names to be entirely in CAPITALS (Y/N) ?
  4722.           Do you want periods (full stops) after each initial (Y/N) ?
  4723.           Do you want spaces between initials (Y/N) ?
  4724.  
  4725.                In each case the current state of the name format is shown
  4726.           and the answer already in the box chooses the current state. You
  4727.           may change the answer to alter the format, and the example will
  4728.           change to reflect this alteration.
  4729.  
  4730.                After these simple yes/no responses, you have to define some
  4731.           more complicated parameters:
  4732.  
  4733.           What do you want between the surname and initials ?
  4734.  
  4735.           (This will only be asked for formats where you have asked for the
  4736.           initials to appear after the name).
  4737.  
  4738.           What do you want between names (when there are more than two) ?
  4739.           What do you want between the last two names ?
  4740.           What do you want after the last name ?
  4741.  
  4742.                These three items represent the characters which are
  4743.           underlined in this example:
  4744.  
  4745.           J Smith, A J MacDonald and P Stephens, (1973)....
  4746.                  ~~             ~~~~~          ~~
  4747.  
  4748.                In each case the answer field is filled with # symbols to
  4749.           represent unused characters. This enables you to specify spaces
  4750.           in the strings that you give.
  4751.  
  4752.           After specifying these items you will be asked:
  4753.  
  4754.           Is the above format for names correct ?
  4755.  
  4756.                Answer "N" if you want to go back and change any of your
  4757.           responses, or "Y" to continue.
  4758.  
  4759.           PUNCTUATION SEPARATING PARTS OF THE REFERENCE
  4760.  
  4761.                Next you will be asked to specify what punctuation is to
  4762.           separate the major parts of the reference. Most styles use either
  4763.           ", " or ". ".
  4764.  
  4765.  
  4766.  
  4767.  
  4768.  
  4769.  
  4770.           BIBLOGIC                                                  Page 76
  4771.  
  4772.                                                                   Reference
  4773.  
  4774.  
  4775.           EDITORS
  4776.  
  4777.                You will then be asked:
  4778.  
  4779.           How do you want the editors to be shown ?
  4780.  
  4781.               1.................(Eds.)
  4782.               2. edited by............
  4783.  
  4784.           YEAR FORMAT
  4785.  
  4786.           For the year format, first you will be asked:
  4787.  
  4788.           Where do you want the year to be positioned ?
  4789.  
  4790.               1. After the authors' names
  4791.               2. At the end of the reference
  4792.               3. After the journal or after publication information
  4793.               4. After the volume or after publication information
  4794.  
  4795.           Then:
  4796.  
  4797.           What do you want before the year ?
  4798.           What do you want after the year (books/chapters) ?
  4799.           What do you want after the year (journal articles) ?
  4800.  
  4801.                These questions allow a wide variety of different
  4802.           punctuation to be used with the year.
  4803.  
  4804.                Note that, depending on the position that you select for the
  4805.           year, other strings may already be positioned before the year.
  4806.           For example: if you elect to position the year after the authors'
  4807.           names, then you will have already selected a string to follow the
  4808.           names. This string will be followed by your answer to "What do
  4809.           you want before the year ?", then the year, then another string.
  4810.  
  4811.                You will then be asked to specify what is to separate a
  4812.           chapter title from a book title. Most styles use "In", "in" or
  4813.           "In:".
  4814.  
  4815.           PUBLISHER FORMAT
  4816.  
  4817.           You will then be given a choice of formats for the publisher (of
  4818.           books or chapters):
  4819.  
  4820.           How do you want the publisher to be shown ?
  4821.  
  4822.               1. publisher, place
  4823.               2. place: publisher
  4824.               3. (publisher, place
  4825.               4. (place: publisher
  4826.  
  4827.  
  4828.  
  4829.           BIBLOGIC                                                  Page 77
  4830.  
  4831.                                                                   Reference
  4832.  
  4833.  
  4834.  
  4835.                The last two of these may seem unusual, but they are used in
  4836.           conjunction with options 3 and 4 for the year position to
  4837.           generate (for example):
  4838.  
  4839.           (New York: Champion & Champion, 1986)
  4840.  
  4841.           VOLUME FORMAT
  4842.  
  4843.           Next you must specify the format of the volume information (in
  4844.           journal articles):
  4845.  
  4846.           How do you want the volume/number to be shown ?
  4847.  
  4848.               1. 10(2) (as stored in database)
  4849.               2. Vol. 10 No. 2
  4850.  
  4851.           What do you want before the volume/supplement number ?
  4852.           What do you want after the volume/supplement number ?
  4853.  
  4854.           PAGE FORMAT
  4855.  
  4856.           You will then be asked to specify the page format:
  4857.  
  4858.           What do you want before the page number (one page item) ?
  4859.           What do you want before the page numbers (multi-page item) ?
  4860.           What do you want between page numbers (multi-page item) ?
  4861.  
  4862.                These questions enable you to specify formats which allow,
  4863.           for example:
  4864.  
  4865.           "page 117"               To be output where only a first page is
  4866.                                    supplied in the reference and
  4867.           "pages 117 to 119"       To be output where a first and last page
  4868.                                    is supplied.
  4869.  
  4870.           NOTES FORMAT
  4871.  
  4872.           You may elect to print the notes field in the reference for
  4873.           special applications:
  4874.  
  4875.           How do you want the notes field shown ?
  4876.  
  4877.               1. Notes field not printed in reference
  4878.               2. Notes field in [ ] at end of reference
  4879.               3. In place of an undefined journal
  4880.  
  4881.           You should choose option 1 unless you have a special application.
  4882.           Option 2 is used when the notes field has been used to record,
  4883.           for example, the location of an article and you want to print a
  4884.           list for your own use, rather than for publication.
  4885.  
  4886.  
  4887.  
  4888.           BIBLOGIC                                                  Page 78
  4889.  
  4890.                                                                   Reference
  4891.  
  4892.  
  4893.  
  4894.           Option 3 can be used with references that have been converted
  4895.           from Medline format to print the journal title information from
  4896.           the notes field if the journal field has not been filled in.
  4897.  
  4898.           SPECIAL PRINTING EFFECTS - DEFINITION
  4899.  
  4900.                The next stage is to define the special characters which
  4901.           will be understood by your word processor to signify "special
  4902.           effects" such as bold, underline and so on. You will be asked if
  4903.           you wish to change these special effect definitions. If you
  4904.           answer "N" you will skip this part of the procedure and go on to
  4905.           SPECIAL EFFECTS - USAGE.
  4906.  
  4907.                If you copied an existing print format file (e.g. the
  4908.           examples supplied with BIBLOGIC) then you will probably not want
  4909.           to change these codes - so answer "N".
  4910.  
  4911.                If you answer "Y" you will be asked to supply names for up
  4912.           to six effects, and then the actual codes for turning these
  4913.           effects on and off. This is a lengthy and somewhat complicated
  4914.           process and you should read the Appendix on Print Format Files
  4915.           (see page 100) before attempting to make changes here.
  4916.  
  4917.           SPECIAL PRINTING EFFECTS - USAGE
  4918.  
  4919.                Next you must specify where the special effects are to be
  4920.           used. The number corresponding to the desired effect should be
  4921.           input against each of the options. These are mostly self
  4922.           explanatory, the code to turn the effect on is output before the
  4923.           item named and the code to turn it off again is output after the
  4924.           item. The last two need some clarification:
  4925.  
  4926.           file           defines an effect, the "on" code for which is
  4927.                          output right at the beginning of the whole file
  4928.                          (list). The "off" code is output right at the end
  4929.                          of the list.
  4930.  
  4931.           reference      defines an effect, the "on" code for which is
  4932.                          output before each complete reference. The "off"
  4933.                          code is output right immediately after each
  4934.                          complete reference.
  4935.  
  4936.                These last two options are used for special formatting
  4937.           purposes in some word processors (see the example PFFs for
  4938.           Microsoft Word, WordStar 2000 or WordPerfect [Trademarks]).
  4939.  
  4940.                After you have specified where the effects are to be used
  4941.           (or you can just press <Enter> for each one to accept the
  4942.           existing scheme) the new print format file is produced and
  4943.           written to disk.
  4944.  
  4945.  
  4946.  
  4947.           BIBLOGIC                                                  Page 79
  4948.  
  4949.                                                                   Reference
  4950.  
  4951.  
  4952.  
  4953.           5.6.6. Edit print format
  4954.  
  4955.                This option works exactly like the previous one, except an
  4956.           existing format is changed rather than a new one being created.
  4957.  
  4958.           5.6.7. Set numbers
  4959.  
  4960.                Under normal circumstances the program will assign the
  4961.           reference numbers to book and journal article references,
  4962.           starting with B1 and J1. If you need to start numbering at a
  4963.           different number, or if you wish to number the references
  4964.           yourself, you can use this option to do so.
  4965.  
  4966.                When you select this option, you will be shown the numbers
  4967.           which would be given to the next references to be input and you
  4968.           should type in the new values.
  4969.  
  4970.                You should avoid using this option unless you have special
  4971.           requirements which make it necessary.
  4972.  
  4973.                If you elect to number your own references the program will
  4974.           not check for duplicated numbers and you may not be able to
  4975.           access some references if you allocate the same number to more
  4976.           than one reference.
  4977.  
  4978.                It is safe to set the values to higher values than their
  4979.           current value - except if you choose a very high value you may
  4980.           run out of numbers sooner than you expect. Assigning a lower
  4981.           number than the current value may result in duplications and
  4982.           should be avoided.
  4983.  
  4984.           5.6.8. Medline/DIALOG conversions
  4985.  
  4986.                This option allows text captured from a MEDLINE or DIALOG
  4987.           search to be used to create a BIBLOGIC database. This option will
  4988.           prompt you for some file names and the type of conversion.
  4989.  
  4990.  
  4991.  
  4992.  
  4993.  
  4994.  
  4995.  
  4996.  
  4997.  
  4998.  
  4999.  
  5000.  
  5001.  
  5002.  
  5003.  
  5004.  
  5005.  
  5006.           BIBLOGIC                                                  Page 80
  5007.  
  5008.                                                                   Reference
  5009.  
  5010.  
  5011.           5.6.8.1. Medline
  5012.  
  5013.                The input file must be in the MEDLINE "RAW INDENTED" format.
  5014.           In the conversion process, BIBLOGIC looks for the following lines
  5015.           in the text, and all other lines are ignored.
  5016.  
  5017.           The lines the program uses start with:
  5018.  
  5019.                a number            Start of a new reference
  5020.                TA  -               Journal
  5021.                MH  -               "Mesh" heading
  5022.                TI  -               Title
  5023.                PG  -               Page
  5024.                DP  -               Date of publication
  5025.                AB  -               Abstract
  5026.                AU  -               Author
  5027.                IP  -               Issue number / supplement
  5028.                AD  -               Author data
  5029.                VI  -               Volume
  5030.  
  5031.                This option will prompt you for the name of the text file to
  5032.           be converted and the name for the new BIBLOGIC database to be
  5033.           created. During the conversion process a report file called
  5034.           "CONVERT.TXT" is generated. This can be inspected using your word
  5035.           processor or by the DOS "type" command to check the converted
  5036.           file. You are advised to check either this report, or the
  5037.           database generated, against the original MEDLINE text before
  5038.           appending the newly generated database to your main database
  5039.           using the IMPORT function.
  5040.  
  5041.                Note that the conversion from MEDLINE format puts the
  5042.           journal title into the notes field. You may then put in the
  5043.           correct numbers manually using you journal list. You may also do
  5044.           this by editing the MEDLINE text file before conversion. If
  5045.           BIBLOGIC finds a number where the journal title should be in the
  5046.           MEDLINE text, it will be put directly into the journal field
  5047.           rather than the notes field. This is better than relying on the
  5048.           journal titles being put into the notes field. This is because
  5049.           long journal titles may be truncated.
  5050.  
  5051.                In the conversion, the MEDLINE "MH", "AB" and "AD" fields
  5052.           will be put into the comments field in the review. The other
  5053.           fields listed above are put into the appropriate field in the
  5054.           reference. A single review is generated for each reference. It is
  5055.           left up to the user to put in an appropriate topic code and to
  5056.           add more reviews if appropriate.
  5057.  
  5058.  
  5059.  
  5060.  
  5061.  
  5062.  
  5063.  
  5064.  
  5065.           BIBLOGIC                                                  Page 81
  5066.  
  5067.                                                                   Reference
  5068.  
  5069.  
  5070.           5.6.8.2. DIALOG
  5071.  
  5072.                This conversion works in a similar manner to the Medline
  5073.           conversion, except the lines which are used begin with different
  5074.           characters.
  5075.  
  5076.                In the conversion process, BIBLOGIC looks for the following
  5077.           lines in the text, and all other lines are ignored.
  5078.  
  5079.           The lines the program uses start with:
  5080.  
  5081.                <  or a number      Start of a new reference
  5082.                JN-                 Journal
  5083.                DE-                 Subject heading
  5084.                BT-                       "
  5085.                GL-                       "
  5086.                BC-                       "
  5087.                CC-                       "
  5088.                SC-                       "
  5089.                TI-                 Title
  5090.                PG-                 Page
  5091.                PY-                 Publication Year
  5092.                AB-                 Abstract
  5093.                AU-                 Author
  5094.                CS-                 Author data
  5095.                PU-                       "
  5096.                VO-                 Volume
  5097.                IS-                 Issue
  5098.                NO-                 Number
  5099.                SH-                 Heading
  5100.  
  5101.                Note that the conversion from DIALOG format puts the journal
  5102.           title into the notes field. You may then put in the correct
  5103.           numbers manually using you journal list. You may also do this by
  5104.           editing the DIALOG text file before conversion. If BIBLOGIC finds
  5105.           a number where the journal title should be in the DIALOG text, it
  5106.           will be put directly into the journal field rather than the notes
  5107.           field. This is better than relying on the journal titles being
  5108.           put into the notes field. This is because long journal titles may
  5109.           be truncated.
  5110.  
  5111.                In the conversion, the DIALOG IS-, VO-, NO- and subject
  5112.           heading fields will be put into the comments field in the review.
  5113.           The other fields listed above are put into the appropriate field
  5114.           in the reference. A single review is generated for each
  5115.           reference. It is left up to the user to put in an appropriate
  5116.           topic code and to add more reviews if appropriate.
  5117.  
  5118.  
  5119.  
  5120.  
  5121.  
  5122.  
  5123.  
  5124.           BIBLOGIC                                                  Page 82
  5125.  
  5126.                                                                   Reference
  5127.  
  5128.  
  5129.           5.7. THE UTILITIES MENU
  5130.  
  5131.                The UTILITIES menu allows you to add references to the
  5132.           current database from another BIBLOGIC database, or to extract
  5133.           references from the current database to form a new one. For
  5134.           conversion from other types of databases see the SET-UP menu on
  5135.           new databases (see page 74).
  5136.  
  5137.           The options on the UTILITIES menu are:
  5138.  
  5139.                               1. Import
  5140.                               2. Export
  5141.                               3. Pack database
  5142.                               4. Topic code changes
  5143.                               5. Register
  5144.  
  5145.           5.7.1. Import
  5146.  
  5147.                When you select the import option you will be asked for the
  5148.           name of a BIBLOGIC database. You will be asked to confirm this
  5149.           operation. This database in its entirety will be added to the
  5150.           current database.
  5151.  
  5152.                The B & J numbers of the added references will be increased
  5153.           to place them after the existing references, and the
  5154.           corresponding reviews will be altered accordingly. Please note
  5155.           that the journal title numbers and topic codes of the appended
  5156.           references are not altered, so the topic and journal numbering
  5157.           schemes of the current database and the appended database must be
  5158.           consistent. It is best to change these (if necessary) in the
  5159.           database to be appended before adding the new references to the
  5160.           current database. It is also advisable to print out a reference
  5161.           list with B/J numbers for the database to be added so that the B
  5162.           and J numbers are known after the appending process.
  5163.  
  5164.           5.7.2. Export
  5165.  
  5166.                The EXPORT option will prompt you to provide a topic code
  5167.           (or B/J number) to select references for output in the same way
  5168.           as the list options. You will also be asked for a name for the
  5169.           new database. If you select a name which already exists, you will
  5170.           be asked whether you really do wish to overwrite that database.
  5171.           Be careful that you do not overwrite a database that you wish to
  5172.           keep. The appropriate reviews, book references and journal
  5173.           article references will then be output to a new database. The
  5174.           references will be given new B/J numbers, starting at B1 and J1
  5175.           and the reviews will be altered accordingly.
  5176.  
  5177.  
  5178.  
  5179.  
  5180.  
  5181.  
  5182.  
  5183.           BIBLOGIC                                                  Page 83
  5184.  
  5185.                                                                   Reference
  5186.  
  5187.  
  5188.           The above functions are straightforward to use, but their very
  5189.           nature makes them potentially destructive if they are used
  5190.           indiscriminately. You are therefore advised to try them out on
  5191.           COPIES of your databases until you fully understand their use.
  5192.  
  5193.           5.7.3. Pack database
  5194.  
  5195.                This option allows you to actually remove deleted items from
  5196.           the database. When a reference or review is "deleted" it is
  5197.           marked as being deleted, but the space it takes up in the
  5198.           database is not reclaimed. This option will actually reduce the
  5199.           size of the database by reclaiming the space used by deleted
  5200.           items. It is only necessary to use this option if you have made a
  5201.           large number of deletions and you wish to reclaim disk space or
  5202.           speed up the operation of the program.
  5203.  
  5204.                This operation can take several minutes for a large
  5205.           database.
  5206.  
  5207.           5.7.4. Topic code changes
  5208.  
  5209.                This option allows you to make changes to all of the topic
  5210.           codes in the reviews in a database at one time. It allows you to
  5211.           make changes to your tree structure even when a large number of
  5212.           reviews have already been input. This function is somewhat
  5213.           limited however, and should not be relied upon as a substitute
  5214.           for careful tree design in the first place ! It is suggested that
  5215.           you use these options on a copy of your database, rather than on
  5216.           the database itself, as irreversible changes can be made to the
  5217.           reviews in a database. The options are as follows.
  5218.  
  5219.           5.7.4.1. Add column
  5220.  
  5221.                This option allows you to add a column in the codes so that
  5222.           (for example):
  5223.  
  5224.                                     "1234567890"
  5225.           becomes:
  5226.                                     "12345 6789"
  5227.  
  5228.           Note that the digit or letter in column 10 will be lost.
  5229.  
  5230.                Inserting a column before column 1 has the effect of moving
  5231.           the codes one position rightwards (losing column 10).
  5232.  
  5233.           5.7.4.2. Delete column
  5234.  
  5235.                This option allows you to remove a column from the code.
  5236.           Columns to the right of the deleted columns will be moved
  5237.           leftwards one position and the tenth column becomes blank so that
  5238.           (for example):
  5239.  
  5240.  
  5241.  
  5242.           BIBLOGIC                                                  Page 84
  5243.  
  5244.                                                                   Reference
  5245.  
  5246.  
  5247.  
  5248.                                     "1234567890"
  5249.           becomes:
  5250.                                     "124567890 "
  5251.  
  5252.                Deleting column 1 has the effect of moving the codes one
  5253.           position leftwards (losing column 1).
  5254.  
  5255.           5.7.4.3. Individual substitutions
  5256.  
  5257.                Individual substitutions can be made in the following ways.
  5258.  
  5259.                A single code with all the columns specified may be replaced
  5260.           with another code throughout the database, or a number of codes
  5261.           (specified with an asterisk "*" in one or more columns) may be
  5262.           replaced.
  5263.  
  5264.                The replacement may be a fully specified code (i.e. all ten
  5265.           columns are given) or it may contain asterisks "*", in which case
  5266.           the columns containing asterisks will be unmodified.
  5267.  
  5268.                Note that the effect of the asterisks in the code being
  5269.           replaced is different to the effect in the replacement code. In
  5270.           the first case the asterisk means "change the code whatever is in
  5271.           this column". In the second case it means "do not change this
  5272.           column".
  5273.  
  5274.                When you have filled out both codes, you will be asked to
  5275.           confirm that the substitution is to go ahead.
  5276.  
  5277.                If the changes you are making to your tree structure are
  5278.           extensive you may need to use this option many times. If your
  5279.           changes require using this option repeatedly, you should be
  5280.           careful that the change you make does not give rise to codes
  5281.           which already exist and are to be changed. For example, you
  5282.           cannot change:
  5283.  
  5284.                             "X*********" to "YQT*******"
  5285.           and then
  5286.                             "Y*********" to "PQRST*****"
  5287.  
  5288.           without all codes starting with X or Y ending up as "PQRST....".
  5289.           These particular changes could be done in the opposite order with
  5290.           an entirely different effect. You could change codes to an
  5291.           intermediate value and then subsequently change them again (after
  5292.           other changes that would have affected them have been made).
  5293.  
  5294.                It is stressed that you should use this options on a copy of
  5295.           your database, rather than on the database itself, as
  5296.           irreversible changes can be made to the reviews in a database.
  5297.  
  5298.  
  5299.  
  5300.  
  5301.           BIBLOGIC                                                  Page 85
  5302.  
  5303.                                                                   Reference
  5304.  
  5305.  
  5306.           5.7.5. Register
  5307.  
  5308.                This option displays instructions on how to register your
  5309.           copy of BIBLOGIC. When Biblogic Computer Services receives your
  5310.           registration payment you will be sent a serial number for your
  5311.           copy of the program. Use this option to type in the serial
  5312.           number. This action will mark your copy and de-activate the
  5313.           sign-on screen which displays each time BIBLOGIC is run.
  5314.  
  5315.           5.8. EXIT
  5316.  
  5317.                The EXIT menu has just one option, that is to exit from
  5318.           BIBLOGIC. Press <Enter> when this menu is displayed to exit from
  5319.           the BIBLOGIC program. If the program was run directly from DOS
  5320.           you will be returned to DOS. If BIBLOGIC was run from within
  5321.           another program (for example a menu program) you will be returned
  5322.           to that program.
  5323.  
  5324.  
  5325.  
  5326.  
  5327.  
  5328.  
  5329.  
  5330.  
  5331.  
  5332.  
  5333.  
  5334.  
  5335.  
  5336.  
  5337.  
  5338.  
  5339.  
  5340.  
  5341.  
  5342.  
  5343.  
  5344.  
  5345.  
  5346.  
  5347.  
  5348.  
  5349.  
  5350.  
  5351.  
  5352.  
  5353.  
  5354.  
  5355.  
  5356.  
  5357.  
  5358.  
  5359.  
  5360.           BIBLOGIC                                                  Page 86
  5361.  
  5362.                                                                  Appendices
  5363.  
  5364.  
  5365.           Appendix A. Installing BIBLOGIC on disk drives other than C:
  5366.  
  5367.                The following instructions will be relevant in only a few
  5368.           cases, so they have been included as an appendix.
  5369.  
  5370.                The installation program allows you to install BIBLOGIC on a
  5371.           drive other than drive C: simply by typing in a different drive
  5372.           letter at the appropriate prompt during installation.
  5373.  
  5374.                The only complication that could arise is if, for some
  5375.           reason (for example in certain network situations) the
  5376.           installation program is unable to correctly identify your boot
  5377.           drive and hence locate your CONFIG.SYS file.
  5378.  
  5379.                Under these circumstances the CONFIG.SYS file can simply be
  5380.           edited manually.
  5381.  
  5382.  
  5383.  
  5384.  
  5385.  
  5386.  
  5387.  
  5388.  
  5389.  
  5390.  
  5391.  
  5392.  
  5393.  
  5394.  
  5395.  
  5396.  
  5397.  
  5398.  
  5399.  
  5400.  
  5401.  
  5402.  
  5403.  
  5404.  
  5405.  
  5406.  
  5407.  
  5408.  
  5409.  
  5410.  
  5411.  
  5412.  
  5413.  
  5414.  
  5415.  
  5416.  
  5417.  
  5418.  
  5419.           BIBLOGIC                                                  Page 87
  5420.  
  5421.                                                                  Appendices
  5422.  
  5423.  
  5424.           Appendix B. Running BIBLOGIC from other directories
  5425.  
  5426.                If you want to run BIBLOGIC from different directories (for
  5427.           example for different users) you must do the following:
  5428.  
  5429.           1)   Create subdirectories for each database.
  5430.  
  5431.           2)   Put the \BIBLOGIC directory on the search path so that DOS
  5432.                can find the BIBLOGIC program whenever you type
  5433.                "BIBLOGIC<Enter>" at the DOS prompt. See your DOS manual for
  5434.                details on how to use the DOS "path" command.
  5435.  
  5436.           3)   When you first run BIBLOGIC from a particular directory a
  5437.                set-up file "BIBLOGIC.BSU" will be created in that
  5438.                directory. This will define the default set-up:
  5439.  
  5440.                Database name:      "DATABASE"
  5441.                Journal list:       "JOURNALS"
  5442.                Print format:       "PRINTFOR"
  5443.                Printer:            None
  5444.  
  5445.                You will then have to go to the SET-UP menu and alter these
  5446.                values if these are not what you require. Note that this
  5447.                set-up will be "private" to the directory you are in and
  5448.                will always be in effect when the program is run in this
  5449.                directory. Usually, you will want to set up databases with
  5450.                different names for each user, even though the databases
  5451.                will be stored in separate subdirectories. This will avoid
  5452.                any possible confusion between databases when, for example,
  5453.                files are copied to floppies or transferred from one machine
  5454.                to another.
  5455.  
  5456.           4)   Copy any print format files, journal lists etc. that you
  5457.                will need into this directory. Note that any changes you
  5458.                make to these files will only be effective when running the
  5459.                program from this directory.
  5460.  
  5461.           Note that there are certain files (.DBF files) which BIBLOGIC
  5462.           uses to create new files which it must be able to find in the
  5463.           \BIBLOGIC directory. These need not be copied to the new
  5464.           directories.
  5465.  
  5466.                The above-described method of setting up BIBLOGIC is ideal
  5467.           when setting up a system to be used by novice users, since they
  5468.           simply have to "cd" to their own directory and run BIBLOGIC. A
  5469.           menu program can be used to isolate the users from DOS. Do not,
  5470.           however, install a menu system for a novice user if you (or
  5471.           somebody else) is not going to stay around to maintain the
  5472.           system. Novice users who have to operate substantially on their
  5473.           own should be encouraged to learn the rudiments of DOS.
  5474.  
  5475.  
  5476.  
  5477.  
  5478.           BIBLOGIC                                                  Page 88
  5479.  
  5480.                                                                  Appendices
  5481.  
  5482.  
  5483.           Running with BIBLOGIC.EXE in a different location
  5484.  
  5485.                BIBLOGIC always works in the current directory for database,
  5486.           print format, and journal list files. This allows "private"
  5487.           sub-directories to be set up as described above so that users do
  5488.           not interfere with each other's data. BIBLOGIC also uses certain
  5489.           files (such as NLSSTRUC.DBF) which, by default, it expects to
  5490.           find in "\BIBLOGIC". Normally, the method of setting up described
  5491.           above will be appropriate in a situation where more than one user
  5492.           is using the program. Each user can simply go to their own
  5493.           sub-directory and type BIBLOGIC to run the program. Data specific
  5494.           to the user is obtained from the current directory while BIBLOGIC
  5495.           system files are still available to the program because it looks
  5496.           for them in subdirectory \BIBLOGIC (on the current drive) by
  5497.           default. If, for some reason, you want to run BIBLOGIC in a
  5498.           directory other than "\BIBLOGIC" you must use the DOS set command
  5499.           in your AUTOEXEC.BAT to set up the environment variable BIBLOGIC.
  5500.           For example:
  5501.  
  5502.           set BIBLOGIC=D:\APPS\BIBLOGIC
  5503.  
  5504.           will cause BIBLOGIC to look in a different subdirectory for its
  5505.           system files. If the environment variable "BIBLOGIC" has been
  5506.           set, its value overrides BIBLOGIC's search path for system files.
  5507.           Note that, however, the location of program overlays is
  5508.           determined from the system path.
  5509.  
  5510.           The set-up file BIBLOGIC.BSU from the CURRENT directory is used
  5511.           when BIBLOGIC is run. Note also that there MUST NOT be spaces
  5512.           either side of the = sign in the SET command.
  5513.  
  5514.  
  5515.  
  5516.  
  5517.  
  5518.  
  5519.  
  5520.  
  5521.  
  5522.  
  5523.  
  5524.  
  5525.  
  5526.  
  5527.  
  5528.  
  5529.  
  5530.  
  5531.  
  5532.  
  5533.  
  5534.  
  5535.  
  5536.  
  5537.           BIBLOGIC                                                  Page 89
  5538.  
  5539.                                                                  Appendices
  5540.  
  5541.  
  5542.           Appendix C. Field sizes
  5543.  
  5544.           STRUCTURE OF THE DATABASES
  5545.  
  5546.                The sizes of the individual fields in a record are chosen as
  5547.           a compromise between overall database size and fitting in the
  5548.           actual information to be stored.
  5549.  
  5550.                In order to move around the database quickly, all records
  5551.           must be the same size (with the exception of the comments field
  5552.           in the review database). Records with short titles, for example,
  5553.           still take up the space taken by the largest possible title to be
  5554.           stored in the system. Keeping these sizes to a minimum then,
  5555.           reduces the overall size of the database and thus increases the
  5556.           number of records which can be stored on the disk.
  5557.  
  5558.                Fields which overflow can be accommodated (see page 54), but
  5559.           if this were to occur frequently a great deal of "patching up" of
  5560.           the final reference lists would be required.
  5561.  
  5562.                The sizes chosen were based on an actual database containing
  5563.           about 3000 references. The program has been written so that
  5564.           future versions can have slightly different field sizes if
  5565.           necessary. Adjustments (up or down in size) will be made based on
  5566.           actual user experience.
  5567.  
  5568.           MANIPULATION OF DATABASES OUTSIDE BIBLOGIC
  5569.  
  5570.                All of the databases are compatible with dBASEIII+
  5571.           (Trademark of Ashton Tate) and they may be manipulated using
  5572.           dBASEIII+. The names assigned to the various fields should be
  5573.           self explanatory, but look also at their contents in one of your
  5574.           databases. Note that BIBLOGIC uses a different method of indexing
  5575.           to dBASE III+ and that BIBLOGIC's indexes to a database which has
  5576.           been altered or created outside BIBLOGIC must be deleted before
  5577.           running BIBLOGIC so that it is forced to rebuild them. This is
  5578.           easily done by deleting (for example) "DATABASE.I*" in DOS before
  5579.           running BIBLOGIC. Failure to do this may result in irreversible
  5580.           damage to the database by use of an inappropriate index by
  5581.           BIBLOGIC.
  5582.  
  5583.                At the time of writing, it is believed that dBASEIV cannot
  5584.           be used to create or manipulate BIBLOGIC files because of
  5585.           differences in the file headers between dBASEIII and dBASEIV.
  5586.  
  5587.           The field sizes are as listed overpage.
  5588.  
  5589.  
  5590.  
  5591.  
  5592.  
  5593.  
  5594.  
  5595.  
  5596.           BIBLOGIC                                                  Page 90
  5597.  
  5598.                                                                  Appendices
  5599.  
  5600.  
  5601.           Books database (.BKS File)        Journal articles (.JAR file)
  5602.  
  5603.           Authors (x5)                      Authors (x8)
  5604.           Last name   Character     25      Last Name   Character     25
  5605.           Initial 1   Character      1      Initial 1   Character      1
  5606.           Initial 2   Character      1      Initial 2   Character      1
  5607.           Initial 3   Character      1      Initial 3   Character      1
  5608.  
  5609.           Editors (x3)                      Year        Character      5
  5610.           Last name   Character     25      Title       Character    210
  5611.           Initial 1   Character      1      Journal     Numeric        4
  5612.           Initial 2   Character      1      Volume      Character      7
  5613.           Initial 3   Character      1      Supplement  Character      4
  5614.                                             Page start  Character      5
  5615.           Year        Character      5      Page end    Character      5
  5616.           Chapter     Character    150      Ref. number Numeric        5
  5617.           Book        Character    150      Notes       Character     25
  5618.           Edition     Character      5      Cited B/J   Character      1
  5619.           Publisher   Character     60      Number      Numeric        5
  5620.           Place/pub   Character     30      Use ?       Logical        1
  5621.           Page start  Character      5                               ---
  5622.           Page end    Character      5      ** Total **              501
  5623.           Ref. number Numeric        5
  5624.           Notes       Character     25
  5625.           Cited B/J   Character      1
  5626.           Number      Numeric        5
  5627.           Use ?       Logical        1
  5628.                                    ---
  5629.           ** Total **              671
  5630.  
  5631.  
  5632.  
  5633.  
  5634.  
  5635.  
  5636.  
  5637.  
  5638.  
  5639.  
  5640.  
  5641.  
  5642.  
  5643.  
  5644.  
  5645.  
  5646.  
  5647.  
  5648.  
  5649.  
  5650.  
  5651.  
  5652.  
  5653.  
  5654.  
  5655.           BIBLOGIC                                                  Page 91
  5656.  
  5657.                                                                  Appendices
  5658.  
  5659.  
  5660.           Reviews database (.RVU file)
  5661.  
  5662.           Ref. number Character      6
  5663.           Topic       Character     10
  5664.           Page        Character      5
  5665.           Comments    Memo          10 (pointer into .DBT file)
  5666.                                    ---
  5667.           ** Total **               31
  5668.  
  5669.           Comments (.DBT file)
  5670.  
  5671.           The maximum size of comment that the program can handle is
  5672.           approximately 65,000 characters. Note that this limit is larger
  5673.           than dBASE III allows.
  5674.  
  5675.           Journal list (.JLS file)
  5676.  
  5677.           Number      Numeric        4
  5678.           Title       Character    150
  5679.                                    ---
  5680.           ** Total **              154
  5681.  
  5682.  
  5683.  
  5684.  
  5685.  
  5686.  
  5687.  
  5688.  
  5689.  
  5690.  
  5691.  
  5692.  
  5693.  
  5694.  
  5695.  
  5696.  
  5697.  
  5698.  
  5699.  
  5700.  
  5701.  
  5702.  
  5703.  
  5704.  
  5705.  
  5706.  
  5707.  
  5708.  
  5709.  
  5710.  
  5711.  
  5712.  
  5713.  
  5714.           BIBLOGIC                                                  Page 92
  5715.  
  5716.                                                                  Appendices
  5717.  
  5718.  
  5719.           Appendix D. Comments field editing
  5720.  
  5721.  
  5722.                On page 57 the comments editor (word processor) was briefly
  5723.           introduced.
  5724.  
  5725.                This editor can handle a maximum of approximately 65,000
  5726.           characters which is about 800-1500 lines (depending on their
  5727.           length). This sets the limit for the maximum amount of text you
  5728.           can put into a single comments field in a review.
  5729.  
  5730.           Commands
  5731.  
  5732.           <"Up-arrow">        Cursor up one line
  5733.           <"Down-arrow">      Cursor down one line
  5734.           < <- >              Cursor left one character
  5735.           < -> >              Cursor right one character
  5736.           <Ctrl -> >          Cursor right one word
  5737.           <Ctrl <- >          Cursor left one word
  5738.           <Home>              Cursor to beginning of line
  5739.           <End>               Cursor to end of line
  5740.           <Ctrl Home>         Cursor to beginning of comment
  5741.           <Ctrl End>          Cursor to end of comment
  5742.           <Pg Up>             Cursor up one "screenful"
  5743.           <Pg Dn>             Cursor down one "screenful"
  5744.           <Del>               Delete character at cursor position
  5745.           <Ctrl T>            Delete word at cursor
  5746.           <Ctrl Y>            Delete line at cursor
  5747.           <Ins>               Switch from "Insert" to "Overtype" mode.
  5748.                               "Ins" shows at the top of screen when in
  5749.                               insert mode. In insert mode characters typed
  5750.                               push existing text along to make room for the
  5751.                               new text. In overtype mode new text typed
  5752.                               replaces the old text.
  5753.           <Backspace>         Delete character to left of cursor
  5754.           <Ctrl B>            Reformat text in window
  5755.           <Esc>               Abort changes, exit comments field
  5756.           <F4> or <Ctrl W>    Save comments and exit
  5757.  
  5758.           Formatting of text in print-outs
  5759.  
  5760.                When typing text into a comment, do not use tabs and spaces
  5761.           to elaborately set out the text in tables and so on. Such
  5762.           formatting cannot be guaranteed to be preserved through to the
  5763.           final word processor file because the tabs and margins are
  5764.           eventually decided by the word processor, not BIBLOGIC.
  5765.  
  5766.                Instead, type the text in without pressing <Enter> except to
  5767.           separate paragraphs. To separate paragraphs use two consecutive
  5768.           carriage returns: "<Enter><Enter>".
  5769.  
  5770.  
  5771.  
  5772.  
  5773.           BIBLOGIC                                                  Page 93
  5774.  
  5775.                                                                  Appendices
  5776.  
  5777.  
  5778.                Lists in "point form" for example:
  5779.  
  5780.           1) Switch on the kettle
  5781.           2) Get the teabags
  5782.           3) Wait for the kettle to boil
  5783.  
  5784.           should be typed on separate lines with <Enter><Enter> at the end
  5785.           of each line.
  5786.  
  5787.  
  5788.  
  5789.  
  5790.  
  5791.  
  5792.  
  5793.  
  5794.  
  5795.  
  5796.  
  5797.  
  5798.  
  5799.  
  5800.  
  5801.  
  5802.  
  5803.  
  5804.  
  5805.  
  5806.  
  5807.  
  5808.  
  5809.  
  5810.  
  5811.  
  5812.  
  5813.  
  5814.  
  5815.  
  5816.  
  5817.  
  5818.  
  5819.  
  5820.  
  5821.  
  5822.  
  5823.  
  5824.  
  5825.  
  5826.  
  5827.  
  5828.  
  5829.  
  5830.  
  5831.  
  5832.           BIBLOGIC                                                  Page 94
  5833.  
  5834.                                                                  Appendices
  5835.  
  5836.  
  5837.           Appendix E. Backing up, considerations for advanced users
  5838.  
  5839.                If you are a seasoned computer user you will realize that
  5840.           the advice on backing up on page 48 does not tell the whole
  5841.           story. Incremental backups based on the state of the attributes
  5842.           bits in files are a safe way of backing up, but often much more
  5843.           data is copied in each backup than is really necessary. With big
  5844.           files such as those handled by BIBLOGIC backing up the changed
  5845.           files, and keeping all the previous copies of the files is
  5846.           certainly safe, but if your backups are to floppy disk you will
  5847.           either be knee deep in disks pretty soon, or you will be starting
  5848.           a fresh backup from scratch much more often than you would like.
  5849.  
  5850.                The answer is simple, but you will need to design your own
  5851.           strategy to suit you own purposes. The author of the program now
  5852.           uses a tape backup system, but when floppy disks were used in the
  5853.           past, the technique described below was used.
  5854.  
  5855.                A number of different programs to back up data to floppy
  5856.           disk are available. You can use the DOS "Backup" command, or
  5857.           contact your local dealer for other options.
  5858.  
  5859.           *****************************************************************
  5860.           NOTE: This technique is described here to help you design your
  5861.           own backup strategy. It is not absolutely foolproof, and may not
  5862.           suit your application - so if you use these suggestions, you do
  5863.           so at your own risk.
  5864.           *****************************************************************
  5865.  
  5866.           Initially a batch file called FULLBACK is used carry out the
  5867.           following process:
  5868.  
  5869.           1)   A utility program is used to set the "archive" bits on all
  5870.                files on the hard disk.
  5871.  
  5872.           2)   The archive bit on all ".BAK" files (backups produced by
  5873.                word processors) are then cleared.
  5874.  
  5875.           3)   A backup of all files with the archive bit set is made (i.e.
  5876.                everything on the disk but the .BAK files).
  5877.  
  5878.  
  5879.           Every day that the system is used, a batch file called PARTBACK
  5880.           is used to carry out the following:
  5881.  
  5882.           1)   The archive bit on all the files in the BIBLOGIC
  5883.                subdirectory is cleared.
  5884.  
  5885.  
  5886.  
  5887.  
  5888.  
  5889.  
  5890.  
  5891.           BIBLOGIC                                                  Page 95
  5892.  
  5893.                                                                  Appendices
  5894.  
  5895.  
  5896.           2)   A backup of all files with the archive bit set is made (i.e.
  5897.                everything that has changed since the last backup EXCEPT the
  5898.                files in the BIBLOGIC subdirectory). These files are added
  5899.                to the end of the backup made with FULLBACK
  5900.  
  5901.           When the total size of the backup set of disks gets too large
  5902.           FULLBACK is used again to start another backup set. The above
  5903.           process takes care of everything on the system EXCEPT THE FILES
  5904.           IN BIBLOGIC. Because of their size they are handled differently.
  5905.           Every time BIBLOGIC is used to add a significant amount of
  5906.           information a batch file called BIBLBACK is used to do the
  5907.           following:
  5908.  
  5909.           1)   The archive bits on all files in BIBLOGIC are set.
  5910.  
  5911.           2)   The archive bits on all the index (*.I*) files are cleared
  5912.                (the indexes can easily be rebuilt and do not need to be
  5913.                backed up).
  5914.  
  5915.           3)   Everything in the BIBLOGIC subdirectory with the archive bit
  5916.                set is backed up to a different set of disks to those used
  5917.                for the PARTBACK/FULLBACK process. These are re-used each
  5918.                time, although two sets are kept and used alternately. This
  5919.                means that only the last two versions of the data in
  5920.                BIBLOGIC are kept (the FULLBACK process also keeps one,
  5921.                generally much older, copy as well).
  5922.  
  5923.  
  5924.           The problem with this sort of strategy is that a certain amount
  5925.           of the responsibility of keeping track of backups lies with the
  5926.           user. Probably the only (almost) foolproof method of backing up
  5927.           is to use a tape backup system to back up the whole of your hard
  5928.           disk(s) on a daily basis. Rotating through a number of tapes and
  5929.           making an occasional archive tape which is not re-used ensures
  5930.           maximum integrity of your back-ups.
  5931.  
  5932.  
  5933.  
  5934.  
  5935.  
  5936.  
  5937.  
  5938.  
  5939.  
  5940.  
  5941.  
  5942.  
  5943.  
  5944.  
  5945.  
  5946.  
  5947.  
  5948.  
  5949.  
  5950.           BIBLOGIC                                                  Page 96
  5951.  
  5952.                                                                  Appendices
  5953.  
  5954.  
  5955.           Appendix F. The SOUNDEX algorithm
  5956.  
  5957.                The BIBLOGIC program allows the user to perform a special
  5958.           sort of search for authors when the user is unsure of the
  5959.           spelling of an authors name. The search is based on an algorithm
  5960.           known as the "SOUNDEX" algorithm which was originally described
  5961.           in "The Art of Computer Programming".
  5962.  
  5963.                It is not necessary to understand how this algorithm works
  5964.           to use it - this description is included here as a matter of
  5965.           interest.
  5966.  
  5967.                The algorithm works by converting names to be compared into
  5968.           sequences of letters and numbers in such a way that similar names
  5969.           will convert to the same sequence.
  5970.  
  5971.                To convert a name into a code the following procedure is
  5972.           followed:
  5973.  
  5974.           1)   The name is converted to upper case.
  5975.  
  5976.           2)   The first letter of the name becomes the first letter of the
  5977.                code (in other words, there is no conversion of the first
  5978.                letter).
  5979.  
  5980.           3)   Where double letters occur, the duplication is removed.
  5981.  
  5982.           4)   For the rest of the letters in the name, the characters
  5983.                A,E,H,I,O,U,W and Y are omitted.
  5984.  
  5985.           4)   The string is truncated to four characters (or filled out to
  5986.                four characters with zeroes if it is shorter).
  5987.  
  5988.           5)   Letters (other than the first one) are replaced with numbers
  5989.                according to the following scheme:
  5990.  
  5991.                     B,F,P or V               1
  5992.                     C,G,J,K,Q,S,X or Z       2
  5993.                     D or T                   3
  5994.                     L                        4
  5995.                     M or N                   5
  5996.                     R                        6
  5997.  
  5998.           Codes produced in this way for two "similar" names will be the
  5999.           same.
  6000.  
  6001.  
  6002.  
  6003.  
  6004.  
  6005.  
  6006.  
  6007.  
  6008.  
  6009.           BIBLOGIC                                                  Page 97
  6010.  
  6011.                                                                  Appendices
  6012.  
  6013.  
  6014.           The scheme is not, of course, foolproof. It will not help you if
  6015.           you are not sure whether you are looking for Christoff or
  6016.           Kristoff (you would simply have to search twice in this case),
  6017.           but it will enable you to overcome the most common problems with
  6018.           vowels and double letters.
  6019.  
  6020.           Reference:
  6021.  
  6022.           MK Odell & RC Russell in "The Art of Computer Programming", Vol.
  6023.           3, Sorting and Searching", Page 392. Addison & Wesley.
  6024.  
  6025.  
  6026.  
  6027.  
  6028.  
  6029.  
  6030.  
  6031.  
  6032.  
  6033.  
  6034.  
  6035.  
  6036.  
  6037.  
  6038.  
  6039.  
  6040.  
  6041.  
  6042.  
  6043.  
  6044.  
  6045.  
  6046.  
  6047.  
  6048.  
  6049.  
  6050.  
  6051.  
  6052.  
  6053.  
  6054.  
  6055.  
  6056.  
  6057.  
  6058.  
  6059.  
  6060.  
  6061.  
  6062.  
  6063.  
  6064.  
  6065.  
  6066.  
  6067.  
  6068.           BIBLOGIC                                                  Page 98
  6069.  
  6070.                                                                  Appendices
  6071.  
  6072.  
  6073.           Appendix G. On-screen topic help
  6074.  
  6075.                Each time BIBLOGIC is run, it determines what database is
  6076.           being used and then it looks for a text file with the same name
  6077.           as the database and the extension ".HLP", for example
  6078.           "DATABASE.HLP".
  6079.  
  6080.                This text file is an ASCII file created by the user using a
  6081.           word processor or program editor. It should contain notes to
  6082.           remind you about your topic structure. The notes may be just text
  6083.           or, if your word processor or editor allows, they may contain
  6084.           special symbols to make up a diagram of your tree.
  6085.  
  6086.                The file may have more than one page, the pages being
  6087.           separated by a line containing an "@" in the first column (a
  6088.           form-feed character may be used instead).
  6089.  
  6090.                Each page may consist of up to 24 lines of text. Each line
  6091.           should contain 79 characters or less. It is a good idea (but not
  6092.           essential) to number each page on the first line with, for
  6093.           example "PAGE 1".
  6094.  
  6095.                Note that the .HLP file must be an ASCII file, not a word
  6096.           processor document. Most word processors can produce an ASCII
  6097.           file, consult your word processor manual for details.
  6098.  
  6099.                When you are using BIBLOGIC and are about to fill out a
  6100.           topic code field (in a review, or to specify what is to be
  6101.           included in a list) you may call up the information in the ".HLP"
  6102.           file by pressing function key <F1>. You may move from page to
  6103.           page using the <Pg Up> and <Pg Dn> keys or by pressing the number
  6104.           keys <1> to <9> to go directly to a particular page. The up- and
  6105.           down-arrow keys work in the same way as the <Pg Up> and <Pg Dn>
  6106.           keys. To leave the help file, press <Esc>.
  6107.  
  6108.                If you want to make changes to your .HLP file, simply edit
  6109.           it using the word processor or editor that you originally
  6110.           produced it with.
  6111.  
  6112.                An example of a .HLP file is included in the release
  6113.           package.
  6114.  
  6115.  
  6116.  
  6117.  
  6118.  
  6119.  
  6120.  
  6121.  
  6122.  
  6123.  
  6124.  
  6125.  
  6126.  
  6127.           BIBLOGIC                                                  Page 99
  6128.  
  6129.                                                                  Appendices
  6130.  
  6131.  
  6132.  
  6133.           Appendix H. Special effects codes for new word processors
  6134.  
  6135.                BIBLOGIC can be configured for use with most word
  6136.           processors. If the documentation for the word processor does not
  6137.           describe the embedded control codes, they can be often be worked
  6138.           out by creating a simple text file using all the control codes
  6139.           you need and examining what the word processor generates using a
  6140.           program such as DEBUG. This is not an easy procedure to describe
  6141.           to somebody not familiar with DEBUG, ASCII codes and so on, so it
  6142.           is best left to somebody who is !
  6143.  
  6144.                Create a new (empty) file using your word processor and type
  6145.           in some example text using the appropriate special effects. For
  6146.           example:
  6147.  
  6148.           This is Bold text
  6149.           This is Underlined text
  6150.           This is Bold and underline used together
  6151.  
  6152.                Examine the file produced using DEBUG or some similar
  6153.           utility. Depending on the word processor the file (sometimes each
  6154.           page) may start with a header block. Skip over this part of the
  6155.           file until you see the text you typed. Look among this text for
  6156.           control codes. Many word processors use the same codes to turn an
  6157.           effect on or off, but beware, this is not universal. Also, many
  6158.           word processors use the most significant bit for special purposes
  6159.           so you will need to take this into account. If you use DEBUG note
  6160.           that the values are in hexadecimal and you will need to convert
  6161.           them to decimal to generate a BIBLOGIC print format file.
  6162.  
  6163.                If the word processor generates files without a header (e.g.
  6164.           WordStar [Trademark]) then you can simply edit the files
  6165.           generated by BIBLOGIC. If the word processor you use uses headers
  6166.           on its files you will have to create an empty file with the word
  6167.           processor and read in the text from the BIBLOGIC file using a
  6168.           file read command (called "Block read", "Block insert", "File
  6169.           input" or something similar).
  6170.  
  6171.           Problems with special effects.
  6172.  
  6173.                If, when you print a file using your word processor, the
  6174.           special effects you have programmed do not appear in the text it
  6175.           could be for a number of reasons. Examine the symptoms more
  6176.           closely and use the table below to locate the fault.
  6177.  
  6178.  
  6179.  
  6180.  
  6181.  
  6182.  
  6183.  
  6184.  
  6185.  
  6186.           BIBLOGIC                                                  Page 100
  6187.  
  6188.                                                                  Appendices
  6189.  
  6190.  
  6191.  
  6192.           (1)  The special effects do not show up properly in the file when
  6193.                you examine it with your word processor.
  6194.  
  6195.                The simplest cause of this problem is having the wrong print
  6196.                format file selected in the BIBLOGIC configuration. Use
  6197.                option 1 on the SET-UP menu to check this.
  6198.  
  6199.                If this is not the cause of the problem then either you have
  6200.                set the codes up wrongly in the print format file, or the
  6201.                word processor strips control codes when it reads in a text
  6202.                file. If you are absolutely certain that you have set up the
  6203.                codes correctly then, unfortunately you have a word
  6204.                processor which is unable to read in text with special
  6205.                effects already in place. It may be possible to use unusual
  6206.                character strings (for example \B for bold) in place of
  6207.                special effects codes, which can be replaced with effects
  6208.                codes using the word processor's "find and replace"
  6209.                function. You must use a combination of characters that you
  6210.                will not want to include in regular text, to avoid
  6211.                accidental replacements.
  6212.  
  6213.           (2)  The special effects show up properly in the file when you
  6214.                examine it with your word processor, but they are not
  6215.                printed correctly.
  6216.  
  6217.                You have not properly set up your word processor to drive
  6218.                your printer. Consult the word processor manual and printer
  6219.                manual to rectify this.
  6220.  
  6221.  
  6222.  
  6223.  
  6224.  
  6225.  
  6226.  
  6227.  
  6228.  
  6229.  
  6230.  
  6231.  
  6232.  
  6233.  
  6234.  
  6235.  
  6236.  
  6237.  
  6238.  
  6239.  
  6240.  
  6241.  
  6242.  
  6243.  
  6244.  
  6245.           BIBLOGIC                                                 Page 101
  6246.  
  6247.                                         Index
  6248.  
  6249.  
  6250.           A                                 D
  6251.           Aborting a record, 19             Database
  6252.           Accents, 52                       creating a new one, 74
  6253.           Adding                            file name, 71
  6254.           a book, 15, 52                    DBT files, 13
  6255.           a review, 64                      DIALOG, 82
  6256.           an article, 61                    DOS, 3
  6257.           Advanced features, 49             Duplications, 56
  6258.           ALP file, 69
  6259.           Arrow keys, 9                     E
  6260.           Articles menu, 18                 Editing information, 20
  6261.           Author                            Edition, 53
  6262.           list of authors, 56               Editors, 54
  6263.           skipping over names, 55           Escape key, 10
  6264.                                             Et al., 68
  6265.           B                                 Examine, 21, 60, 63
  6266.           Backing up, 48
  6267.           Basic principles, 9               F
  6268.           BKS file, 12                      Features, 2
  6269.           Bold, 79                          Fields, 13
  6270.           Book reference format, 15         File names, 11, 67
  6271.           Book title, 53                    Files, 11
  6272.           Books menu, 15, 52                Function keys, 10, 56
  6273.                                             F1, 37, 56, 60, 61, 63, 99
  6274.           C                                 F2, 55, 57, 63
  6275.           Categorization, 26, 57, 66        F3, 17, 44, 57
  6276.           Category structure                F4, 17, 44, 57, 93
  6277.           customized, 31                    F5, 43, 74
  6278.           design, 25                        F6, 43, 74
  6279.           display, 37                       F7, 43, 74
  6280.           hierarchical, 26                  F8, 43, 74
  6281.           matrices, 27
  6282.           partial, 40                       G
  6283.           testing, 34                       Goreal, 41
  6284.           Changing information, 20
  6285.           Chapter numbers, 38               H
  6286.           Chapter title, 53                 Hierarchical system, 2
  6287.           Citation, 54, 62                  Hierarchical tree structure, 26
  6288.           Comments
  6289.           listing to a file, 68             I
  6290.           on a reference, 16, 57            IBK files, 13
  6291.           CONFIG.SYS, 7                     IJA files, 13
  6292.           Configuring the program, 71       Import/Export, 49
  6293.           Control key, 10                   Inputting
  6294.           Copying Biblogic, 3               references, 41, 44
  6295.           Copyright, 3                      reviews, 44
  6296.           Cursor movement, 13               Installation, 5
  6297.           around screen, 19                 special cases, 87, 88
  6298.           between records, 19               IRV files, 13
  6299.                                             Italics, 79
  6300.  
  6301.  
  6302.           J
  6303.           JAR file, 12                      O
  6304.           JLS file, 12                      Overflow of fields, 54
  6305.           Journal article title, 61
  6306.           Journal articles menu, 18, 20,    P
  6307.           61                                Page numbers, 53, 57, 62, 79
  6308.           Journal list                      Page up & down keys, 19
  6309.           creating a new one, 73            Parallel printer, 72
  6310.           file name, 71                     Partial categorization, 40
  6311.           modifying an existing one, 73     PFF file, 12, 74
  6312.           Journal name, 43, 61              Place of publication, 53
  6313.                                             Plus symbol, 52
  6314.           K                                 Print format
  6315.           Keyboard markings, 9              creating a new one, 74
  6316.           Keywords, 26                      file name, 71
  6317.                                             modification of, 46
  6318.           L                                 name format, 75
  6319.           Learning BIBLOGIC, 8              page number format, 79
  6320.           Lists - introduction              special effects, 79
  6321.           journal list, 42                  Print screen function, 13
  6322.           options, 45                       Printer port, 72
  6323.           reference list, 21                Publisher, 53
  6324.           Lists menu, 66
  6325.           Long names or titles, 54          Q
  6326.                                             Quiting a record, 19
  6327.           M
  6328.           Main menu, 10, 14, 50             R
  6329.           Matrices, 27                      Real references, 41
  6330.           Medline, 81                       Records, 13
  6331.           Memory Requirements, 3            Reference number
  6332.           Menu                              changing, 80
  6333.           books, 15, 52                     Review - introduction, 16
  6334.           journal articles, 18, 20, 61      Reviews menu, 64
  6335.           lists, 66                         Running Biblogic, 14
  6336.           main, 10, 14, 50                  RVU file, 12
  6337.           reviews, 64
  6338.           set-up, 71                        S
  6339.           Missing information, 54           Screen boxes, 13
  6340.                                             Screen function, 9
  6341.           N                                 Searching, 20, 21, 58
  6342.           Name                              Serial printer, 72
  6343.           in comments list, 68              Set-up menu, 71
  6344.           of author, uncapitalized, 52      Sharing the system, 38
  6345.           of authors, 15, 22, 61, 75        Special effects, 79
  6346.           of city, 53                       Spelling, 59
  6347.           of databases, 11, 71              Starting Biblogic, 14
  6348.           of editors, 15, 54                Supplement, 62
  6349.           of files, 11, 67
  6350.           of journal, 2, 12, 43, 61, 69     T
  6351.           of journal list file, 71          Title, 61
  6352.           of output file, 22, 66            Topic code, 26, 57, 66
  6353.           of print format files, 47         critical date, 39
  6354.           of special effects, 79            marking references, 39
  6355.           skipping over names, 55           zero as, 39
  6356.           too long, 54                      Tree structure, 26
  6357.           NMR file, 69
  6358.           Notes, 53, 62
  6359.           NUM files, 13
  6360.  
  6361.           U
  6362.           Underline, 79
  6363.           Upgrading to latest version, 8
  6364.  
  6365.           V
  6366.           Volume, 62
  6367.  
  6368.           W
  6369.           Warranty, 3
  6370.           Word-processor, 2, 47, 66, 93
  6371.           Writing a record to disk, 19
  6372.  
  6373.           Y
  6374.           Year, 59
  6375.           book reference, 53
  6376.           journal article reference, 62
  6377.  
  6378.           Z
  6379.           Zero, as a category, 39
  6380.  
  6381.  
  6382.